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u Left and right arguments of a function. 
W Left and right argument cells within a and a. 


y Vertical bar separates mutually exclusive alternatives. 


Conventions used in this reference 
Descriptions of functions and operators: 


Left and right function arguments of an operator. 

Left and right array arguments of an operator. 

Derived function (produced by an operator), 

used with one argument or with two arguments. 

Frame shape: lengths of the axes of an array other than 
those used to form an argument cell. 

Shape of individual result produced by evaluating function 
kernel for a single cell of each argument. 

Monadic rank: number of axes per cell when fn used mon- 
adically. 

Left rank: number of axes per a-cell when fn used dyadicallv. 
Right rank: number of axes per u-cell when fn used dyadical- 
ly. 





Elsewhere: 

Account number. 

Example. 

Matrix namelist (one name per row). 
Namelist. mni or vector (or scalar) of names separated bv 
blanks. 

Single name (character vector or scalar). 
Package. 

Workspace. 

Tie number. 

Passnumber. 

Component number. 

Name. 

State indicator (stack of pending functions). 
Carriage return. 

Line feed. 

Left. 

Right. 


U 
me 


Roman brackets (not the APL brackets (1) 
surround an optional portion of an expression. 


Index origin 
Except where explicitiv indicated otherwise. examples which 
are sensitive to index origin assume er, 









4 


Contents 





2 
3 
4 
6 

8 
10 
12 
12 
14 
16 
17 
18 
20 
20 
20 


Index 

Character set, Names: Control 
Scalar functions: Identity elements 
Mixed-rank functions 

Function ranks 

Formatting 

Syntax of operators and functions 
Monadic operators 

Dyadic operators 

Event trapping 

Event numbers 

File system 

Task control 

T-tasks 

N-tasks 

B-tasks 

S-tasks 

Shared variables 

Auxiliary processors 

Package functions 

Workspace reporting 

System reporting; I-beam functions 
Workspace control 

Control of defined functions 
Input/Output 

Filed record of session 
Highspeed printing 

Character set; Alphabets 
Members of [AV 

National use characters 

Explicit control of terminal I/O 
Keyboard: SHARP APL/PC 
Keyboard: APL terminal 
Keyboard: ASCII typewriter-paired 
Keyboard: ASCII bit-paired 
Keyboard: Teletype 

Keyboard: Telex 

System commands 

Line editing 

Function editor 

Network messages 

Selected public workspaces 


NO NN O... 
CO DO OS A NE N NDO 


to SI 
Ww N ra 


t 
Q U 








2 


INDEX 





This index lists the names of 
system functions and variables 


(as if spelled- quad) but does not 


include major headings (found in 
the table of contents) or the 
names of APL primitives. 


Access to file, 19 

Arbitrary 1/O, 37 

Assignment, 3 

Axis operator, 14 

Bracket, 3 

Branching, 3 

B-tasks, 21 

Character set, 3 32 

Colon, 3 

Comment, 3 

Composition operators, 14 15 

Cut operator, 15 

Diamond, 3 

Dual operator, 15 

Enclosed arrays, 8 

Event numbers, 17 

Event trapping, 16 

Execution order, 3 12 13 

Explicit control of terminal I/O, 
30 

File system, 18 

Filing or displaying output, 28 

Format via ¥, 8 9 10 
—, via DFMT, 11 

Function rank, 8 11 

Grouping, 3 

Highspeed printing, 31 

Identity elements, 4 

Input/output, arbitrary, 37 
—, formatting, 8 9 10 11 

Input/Output, System functions, 
29 


Mixed-rank functions, 6 

Name, valid form, 3 

Naming, 3 

Network messages, 46 

N-tasks, 20 

Operators, 12 13 14 15 

Order of execution, 3 12 13 

Output functions, 29 

Output to file, 30 

Package functions, 25 

Parenthesis, 3 

“Picture” format, 10 11 

PC keyboard, 38 

PC files, 18 

PC system commands, 44 

Permission codes for file access, 
19 

Precedence, 12 13 

Public workspaces, 47 

O input and output, 29 

Ti input and output, 29 

QAI, Account information, 27 

DAPPEND, File append, 19 

QAPPENDR, File append /result, 19 

QARBIN, Arbitrary input, 37 

QARBOUT. Arbitrary output. 37 

QAV, Atomic vector, 32 ff 

DAVAIL, File system availability, 
18 

OBOUNCE, Bounce. 20 

DCR, Canonical representation, 28 

DCREATE, File create, 18 

OCT, Comparison tolerance, 9 

ODL, Delay, 27 

DODROP, Drop file components, 19 

DEC, Environment condition for 
trapping, 16 

QER, Event report, 16 

DERASE, File erase, 18 

DEX, Expunge, 28 


OFC, Format control, 9 10 

DFD, Function definition, 28 

OFHOLD., File hold, 19 

OFI. Field input, 29 

OFMT, Format, 11 

OFX, Fix function, 28 

OHOLD, File hold, 19 

QAT, Horizontal tabs, 29 

O70, Index origin, 9 

OLC, Line counter, 28 

OLIB, File library, 18 

OLOAD, Load, 28 

OLX, Latent expression, 28 

OWAME'S, File names, 18 

OVC, Nameclass, 26 

AL, Namelist, 26 

ONUMS, File numbers, 18 

DOUT, Output to file and/or dis- 
play, 30 

PACK, Form a package, 25 

OPDEF, Package define, 25 3 

OPEX, Package expunge, 25 

OPINS, Package insert, 25 

DPLOCK, Package lock. 25 

OPNAMES, Package names, 25 

UPNC, Package nameclass, 25 

OPP, Print precision, 29 8 9 

OPPDEF, Protective package 

define, 25 

OPS, Position and spacing, 8 9 

OPSEZ, Package select, 15 

de, Package value, 15 

22W, Print width, 29 

TZAT, Ouiet-load, 28 

TRIAL, Read access, 19 

MEDCI, Read control information, 
19 

DEAD, File read, 19 

DAENAME, File rename, 18 

UREFLACE, File replace. 19 

ORESIZE, File resize, 19 

021, Random link, 9 

GRUN, Start N-task, 20 

GRUNS, Task information, 20 

SC, State-change variable, 23 

OSIGNAL, Signal event, 17 

QSIZE, File size, 18 19 
7, Session parameter, 28 

OSTAC, Set file access. 19 

OSTIE. Share tie, 18 

OSVC, Shared-variable control, 23 

OSVN, Set clone ID. 23 

OSVO, Shared-variable offer, 23 

OSVQ, Shared-variable query, 23 

DSVA, Shared-variable retract, 23 

OSVS, Shared-variable state, 23 

OTIE, Exclusive tie, 18 

OTRAP, Trap definition, 17 

OTS, Timestamp, 27 

DUL, Userload, 27 

QUNTIE, Untie, 18 

OVI, Validate input, 29 

(OWA, Work area, 26 

(WS, Workspace information, 26 

Quote, 3 

Rank of a function, 8 

Rank operator, 11 

S-tasks. 22 

Scalar functions. 8 4 5 

Statement separator, 3 

Svntax of Operators and Func- 
tons, 12 13 © 

System commands, 44 45 

System functions and variables, 9 
11 23 25-30 

T-tasks, 20 

Task control, 20 

Teletype, 32 42 

Telex, 32 43 


I 


CHARACTER SET 3 





Alphabetic (See also GAV. p. 32.) 
ALFI: PC: abedefghijkimnopgrstuvuxxza 
370: ABCDEFGHIJKLMNOPORSTUVWXIZA 
ALF2: PC: ABCDEFGHITKLMNOPQRSTUVWXYZA 
370: ABCDEFGHIJKLMNOPQESTUVWXIZA 
ALF3: PC: None. 
370: abcdefghijkimnopgrstuvuxxz 
(Majuscule with macron if device lacks minuscule.) 
Numeric. 0123456789 
Other: 7 <<s=2>2#VA+-xtO?weprt+ 10% ee4h 
af L_VAAe'D[I()(Je2>nuiTl,;.:/\ 
vwriedeRoO=VvAVAT!Tar/A&Y*t7 BLANK. 
11 box-drawing characters HE 4 T-+1Lr+ 
Nat'l Glyphs vary by country; see p. 36. North-American defaults: 
use: 123456789 10 11 12 13 14 
cili Men EN A wm ~ \ 


Names Formed from any numeric or alphabetic characters from 
ALF] or ALF2. but may not start with numeric. a or u permit- 
ted as 1-character name within ws. 

Length: Within ws: 1—77 characters. 
Name of ws or file: 370: 1—11 characters. 
PC: 1—8 characters (none from ALF2). 


Number representation 


. Decimal point. 558 > 0.625 

7 Negative sign. 2-3 + 1 

E Exponential. 6.02E23 + 6.02 x 10%23 

J Complex. 1.2/3 47 parts: real 1.2; imaginarv 3. 


BLANK Separate the elements of a vector constant. 
Ex: X+8 3.12 6.02E23 1.5J 21E 6 


Grouping 
(...) Parentheses control order of evaluation. 
Ex: GROWTH+(1+RATE ) «TIME 
[...] Brackets surround R argument of indexed selection and index 
operator. 
Quotes surround character constant. 
Ex: MSG+'DON''T FORGET THE QUOTES' 


Separators 
Colon separates label from body of line. 

; Semicolon separates expressions for successive axes within 
L ] for indexed selection. (Semicolon also tolerated in 
"mixed output” display and within ( ) surrounding R argu- 
ment of OFMT.) 

Ex: A[;I+1N;(JeX)/J] means “From rank-3 array 4, 
selects all planes, rows J+1N, and columns 
(JeX)/J". 

Q Diamond divides line into segments (each a statement), eval- 
uated from L to R. 

A Lamp indicates that the balance of the line is a comment. 
ignored in execution. 


CONTROL 


Order of Within a line, statements from left to right. 
evaluation Within a statement, operators before functions, functions 
from R to L, w before a. 


Naming + 
nm-w Assigns name nm to object w. 
Ex: VALUE+PRICExQUANTITY 
Ex: PRICE(a]+w Substitute elements of w at positions 
a within PRICE. 
Result: Fn to L of ame, as in F X[2]+u, receives w as its argument. 
Note: OFX OFD OPDEF DPPDEF [SVO and system commands )CC>Y 
and )PCOPY may also create named objects. 


Branching > 
>w Transfer control to line (10)pw of defined fn highest on si; 
exit if (10)pw is not a line of that fn. No result. 
Domain. Non-negative integer scalar or vector. 
+10 No effect. 
+ Naked branch. Abort execution of the current fn, and of the 
fn(s) that invoked it (i.e. clear si back until first previously- 
invoked fn marked with x). 
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Domains: S—any simple array; N—numeric; R—real; B—Boolean: 





==== MONADIC USE ==== 


Name Args Description or example å 
+ Conjugate N +3 3J4 ++ 3 37 L 
(unless argument is complex, identity) = 
- Negative N 0-u i 
x Direction i (w=O)xwt lu 


(unless argument is complex, signum) 


: Reciprocal N iw A 

x Exponential N xi + 2.71826... 

@ Natural log N 2.71826... €. e 

[ Ceiling OCT N Smallest integer not less than «. ġ 

L Floor OCT N Largest integer not greater than u. 

| Magnitude N 173 30 4 — 35 TË 

! Factorial N Foti (when « is non-negative integer. | 
x/+Nwol) 

? Roll OIC G22 P Random integer from :.. 

~ Not B Ožu 





d 






< Enclose See Mixed-rank functions, p. 8. 
> Disclose See Mixed-rank functions, p. 8 i 
O Pi times N 01 + 3.14159... | 


Identity elements 

(from reduction along empty axis) 

+ xi 

e None 

| 0 

1 

o None 

A 1 

v 0 

a None 

~ None 

r Smallest representable number — —7.237005577E75 
L Largest representable number + 7.237005577E75 


le X t 
HHOOOHHHOO 


A IV VANI 


m mE MD ER 


mi 


5 


(Result rank and argument ranks all 0) 





P—non-negative integer; C—character. 


==== DYADIC USE ==== 





Name Args Description or example 
+ Plus N 4+6.4 ++ 10.4 
- Minus 4-6.4 4 2.4 
x Times N 4x6. < 25.6 
+ Divide N 4 046.4 0 ++ 0.625 1 
* Power N 213 0.5 — 78 071.4162 
e Log N Log of u to base a 
[ Maximum R Greater of a and u. 
L Minimum R Lesser of a and u. 
| Residue OCT N w-axlwřa+a=0 
! Binomial N (0,18)! — 1466 1 
(lw)s(la)xiw-a 
7 Deal See Mixed-rank functions, p. 9. 
A LCMJAND OCT Noo11mo101—0001 
HAD. Le +— 32 
V GCD/OR DCT N0011v0101* 0111 
uV6.L += 0.6 
A Nand B -aħw 
~ Nor B -avu 
= Equal OCT S usu — 1 O kent — D 
z Not equal OCT S ~azu 
< Less TR 3<3 3.14159 ++ 0 1 
> Greater OCT R 393 3.14159 + 00 
2 Not less OT R 323 3.14152 > 10 
< Not greater OCT R 353 3.14155 +11 
O Circle N a selects monadic fn applied to corresponding 
element of u: 
Positive a Zero or negative (inverse) 
Pythagorean 0 V l-w' 
Vlto 4 V l-w' implemented as 
(w+1)x((w-1)řw+1)x:2 
Vi-w 8 -V l~ur 
Trigonometric Sina 1 Arcsin u 
(arcs in Cos w 2 Arccos u 
radians) Tan ew 3 Arctan u 
Hyperbolic Sinh « 5 Arsinh w 
Cosh u 6 Arcosh u 
Tanhu 7 Artanh w 
Complex 
Cartesian Real: (w++w)+2 9 u (identity) 
Imaginary: (w-+w)+0J2 11 wi — OJixu 
w — 9 7114.09 110.04 
Polar Modulus: lu 10 Conjugate u — tu 
Arc (radians): (@w+|w)#071 12 e — *0J1xw 


w zs 10 12x.010 120 Ow 








6 MIXED-RANK FUNCTIONS 


Domains: S—any simple array; N—numeric; R—real: B—Boolean: 
Integer; P—non-negative integer; C—character; E—any array, in- 
cluding enclosed. 

Args Description or example 





i Index PL Joi 
generator in 1236 
GI040 


1+ + 0123 


, Ravel E Vector of all elements of « in row-major 
order. „u — (x/pu)pu 


> Weak E Conditional enclose: when u is simple. <.: 
enclose otherwise, u. 

Pass E u (i.e. identity). 

= Stop E No result. 

p Shape E Lengths of axes of «. 

& Transpose E Reverse order of axes. 

b Reverse [7] E Reverse positions along one axis. 


Axis selected by axis operator. 
Default axis: last. 


© Reverse [7] E Like © but default is first axis.. 


[I] Indicates function subject to axis operator 
(which is G70-sensitive). 


A. 


(Result rank or argument rank not 0) 7 


Ranks: Each fn is characterized by a 3-element vector of ranks: 
number of axes devoted to a cell of monadic argument, and L and R 
dyadic arguments. (See table. p. 8.) 


Args 


1 Index CIC OCT E 


of 


[ JIndexing O70 EP 


See also 
Axis 


operator, p. 12. 


, Catenate, 
laminate 


U 


Link 


r- Dex 


- Lev 


c Reshape 


t Take 


+ Drop 


[7] E 


PE 


LE 


© Transpose 575 P.E 


© Rotate 


© Rotate 


€ Member 


T Encode 


1 Decode 


[I] LE 


[II LE 
Ger E 


Description or example 


First location of w in vector a. 
"ABOBU'12 3c'ABACUS' — 1 


3 


u N 


X+2 5p'ABLE BAKER' 

X[2;] — BAKER 

XL;3] — IK 

X[2 1;3 1 4] > KBE 
LAE 


Join a and w along axis 7: default axis: last. 
Fractional I: join along inserted axis. 


(<a) ,>u. 

W. 

a. 

A> 2 Bob + 
ABCD ABCDE 
EFGH FGHAE 

X zx Ier, 2 SY 
ABCD * ABCD 
EFGE x EFGE 
IJKI 


Where la exceeds pu. fill numeric « with 0. 
character u with blank: domain error for en- 
closed u. 


X — tat, 1 24X 
ABCD “CD 

FGH *GE 

IJKL 





Re-order axes of u. 
på — u 5 67 
0+ 2 1 IX — 6 5 7 u 
Position in a + axis of u. 
Value in a < axis of result. 
Repeated value in a: diagonal of several axes 
of « mapped to single axis. 
p3 2 2 10X — 7 5 4 


Cyclic rotation by a of each subarray along 
axis I. Default axis: last. 
(pa) +> (Izippw)/pu. 


X— 2 201 — 
ABCDE CDEAE 
EFGHI HIEFG 


Like © but default axis is first. 


Boolean with 1 for each element of a which 
matches an element of u. 


X i Xe! — 
ABC FAST 100 
DEF 001 


Base-a representation of w. 
Z+10 10727 1 1981 5.2 
— 2960 

791 5.2 


Base-a value of w. 

10 1012 += 27 99 81 5.2 

For scalar a, value of polynomial in a with 
coefficients w. 





8 Mixed-rank functions (continued) 
ee ee ee 


7 Roll See Scalar functions, p. 4. 


A Grade up IIS R Like dyadic. but with numeric ordering. 


V Grade down O70 R Like dyadic, but with numeric ordering. 


Fi) 


Matrix N Like dyadic £ when a is i (identity matrix). 


inverse (£w)+.xw approximates i. 
w+.xžw least-squares fit to i. 


< Enclose E Encode entire argument as a scalar. 
> Disclose E Left inverse of <u. a — ><.. 
Where « is simple (i.e. no enclosed elements), 
u * Pu. 
For an enclosed array E, p>F — (2E),SIR. 
where SIR is the (necessarily common) shape of 
each of the elements when disclosed. 
E+(<3 4£112),<3 490:12 
på — 7234 
$ Execute C Execute vector (or scalar) . as a line of APL. 
¥ Format Character representation of a. (Subject to im- 


plicit arguments SFF, ZPS. 
UPP S Gei © FOL 1F10 — 


= m 
3.162 S.i-ZEiC 


Position Spacing 
Within cell Between cells 





FUNCTION RANKS 


Each function is characterized by three argument-ranks: monadic rank 
MR; left rank LR: and right rank RR. These specify the number of axes 
devoted to an argument cell by the function's kernel—its definition 
before modification by an operator. (A scalar function is a function for 
which MR. LR. and RR are all zero, and the rank of the result for a single 
cell is also zero.) The table shows the ranks which apply unless a rank 
is explicitly indicated by the rank operator 5. The symbol U indi- 
cates unlimited rank. The row labelled mr contains blanks for functions 
which do not permit monadic use: the rows labelled LR and MR contain 
blanks where ranks have not yet been assigned. 


Default ranks of mixed functions 


Fn ž < > ¢ , © e A ¥ 2 T e = re 4 > 
MR 2 U 0 U U U U U 0 U U U U 
LR U 0 0 U 0 U U U U U U U 
RR 2 0 0 U U U U U U U U U 
Default ranks not yet assigned: 1: Denis 


Argument frame: When an argument has more axes than the function 
requires, the additional leading axes constitute the frame within which 
the function's kernel is evaluated for each cell. 


Result shape, monadic use: The frame-shape. followed by SIR, the 
(common) shape of the individual results from each cell. 


Result shape, dyadic use: The common frame-shape of a and u, fol- 
lowed by SIR. a and « must have identical frame-shapes, which become 
the frame-shape of the result. However. if one argument has singleton 
frame-shape (i.e. the frame contains no length other than 1) the frame- 
shape of the other argument becomes the frame-shape of the result. 
(But when both arguments have singleton frame-shape, the frame-shape 
of higher rank becomes the frame-shape of the result.) 


L 
I 
i 
l 
i 
i 
i 
i 
i 
i 
E 
e 
i 
i 
: 
l 
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? Deal 70 DAL P a distinct integers at random from 1w. 


Å Grade up (70 C Index vector to permute first axis of u to as- 


cending order with collating sequence a. 


Y Grade down DIO C Like A but descending order. 


E Matrix N Solutions of linear systems. 
divide Values: first, axis of a. 


Coeffs: last 2 axes of w. 
a +> w+.x(alw) (or least-squares fit) 


Match DET E Scalar 1 when a is identical to u; 


0 otherwise. 


v Format OFC N Character array containing representation of 


real component of w. See description on follow- 
ing page. 


IMPLICIT ARGUMENTS 


System variables OZO, OCT, ORL, OPP, OFC and OPS affect results of 
certain fns. (PW affects display, and [AT affects interpretation of entry, 
and display to a terminal; see p. 29.) 


DIO 


OCT 


URL 


OPP 


FC 


OPS 


Index origin. First counting number. Meaningful values: scalar 
O or 1. In clear ws: 1. Affects 1, 7, Å, Y, L ], and dyadic ©. 


Comparison tolerance. Proportion of allowable difference within 
which two quantities are judged “equal”, or fraction judged 
“equal” to integer. Affects dyadic =, =, <, S, >, 2, 1, €, |, A, V, 
and monadic f and L. Meaningful range: scalar less than 16* 8 
++ 2.2328306437E 10 but not less than 0. In clear ws: 
1023x16x 14 ++ 1.419697693E 14. 


Random link. Each use of 2 takes visible (ORL as implicit argu- 
ment, and sets a new value. For given ORL and argument(s) to 
?, result of ? and new value of ORL are completely determined. 
(For repeatable results, set ORL to same initial value; for un- 
repeatable results, set [DAL to arbitrarily different value.) Mean- 
ingful range. scalar integer greater than 0 and less than 
71422831 < 2147483647. In clear ws: 16807. 


Print precision. Maximum digits in representation of floating- 
point number formatted by monadic ¥ or system default display. 
Integer scalar, not less than 1 nor greater than 18. In clear ws: 
10. 


Format control. Character vector affecting result of dyadic use 
of e In clear ws: '.,**_ '. Elements: 

Character to separate integer from fractional part, where a con- 
tains the character '.' used as a decimal point. In clear ws: 
t U 

Character to separate digits where a contains ',' surrounded by 
digits. In clear ws: ','. 

Fill for insignificant position marked by 8. In clear ws: tier, 
Character to indicate that representation is too long for space 
provided. When 0, such a representation is rejected as DOMAIN 
ERROR. In clear ws: rer, 

Substitute BLANK where a contains this character as a controlled 
character (i.e. embedded within the positions devoted to the num- 
ber representation). In clear ws: '_'. 

Reserved for character to indicate negative value (to be imple- 
mented in later release). In clear ws: ' '. 


Position and spacing in display of enclosed array. 4-element 
numeric vector; first two elements control position within cell; 
second two, spacing between cells. 
Vertical position when cell has extra rows: 
71 data at top; 0 centre; 1 bottom. 
Horizontal position when cell has extra columns. 
71 data at left; 0 centre; 1 right. 
Vertical space between cells. 
Magnitude: Number of lines between adjacent cells. 
Sign: When negative, border cell with above and . be- 
low. 
Horizontal space between cells. 
Magnitude: Number of columns between adjacent cells. 
Sign: When negative, border cell with | to left and right. 
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FORMATTING FUNCTIONS 





+ Format 


OFC I,N 


a: 


DFC CN 


Decorator: 


Sign: 


0 


Monadic use. Same characters as system default dis- 
play. See p. 8. 

Dyadic use: Character array containing representation 
of real component of u. (See also DFMT, opposite.) 


Format « with width and precision a. 
Numeric vector; each pair controls formatting of a col- 
umn of w. 
Within each pair: first element sets gross print width; 
second, format and precision. Second element zero: inte- 
ger format; positive: decimal format, value is number of 
positions after decimal point; negative: scientific nota- 
tion, magnitude is number of significant digits. 
Length: a pair for each column of u, or any number of 
pairs that is an even divisor of the number of columns 
(re-used cyclically); one-element a treated as if 0,a. 
Negative value in w: first digit of the representation pre- 
ceded by character in DFC[6] (default ' '). 
1 06 39 39 2 3p01 
— 3 3.142 3.14E0 

3 3.142 3.14E0 
Format by example. 


: Character vector, divided into fields delimited by blanks 


(or by use of digit 6, described below). Within each 
field, representation of w replaces control characters 
„.0123456789 in a. 

A constant field (containing no digit) appears un- 
changed in each row of the result. 

An active field (i.e. containing at least one digit) is 
required for each column of u, or one active field for all. 
Block of consecutive non-control characters to L of first 
control character or to R of last control character in a 
field. Decorator may be blanked, or may float (i.e. move 
to unused positions nearer the units position). 

The sign of an element of « is represented in the result 
only when the corresponding a field contains a non- 
empty decorator and a 1 (show decorator when nega- 
tive) or a 2 (show decorator when non-negative). At- 
tempt to format a negative number in a field which 
contains neither 1 nor 2 nor 3 is treated as “overflow”; 
the result field is filled with the character ZFC[ 4]. 
Control characters 

Decimal marker provided it occurs once in field; blanked 
when no digit follows. 

Grouping delimiter (usually between triplets of digits): 
blanked when no digit further outward. 
Leading/trailing zeros: unused positions filled with © 
from the decimal point outward to here. 

For negative values, the decorator text on this side is 
included and floats; otherwise, it is replaced by blanks. 
For non-negative values, the decorator text on this side 
is included and floats; otherwise, it is replaced by blanks. 
Float: for all values, the decorator text on this side is 
included and floats. 

No float: for all values, the decorator text on this side 
is included but does not float (nullifies the floating im- 
plied by a nearer-in 1, 2 or 3). 

Normal digit: position available for digit, or for sign- 
decorator (when supplied and selected by 1, 2 or 3). 
Field delimiter. next rightward non-control character 
(i.e. any character other than 0123456789.,) is last 
character of this field. (Needed where fields are not 
separated by blank.) 

Exponential format: value is represented in scientific 
notation; next rightward non-control character (for ex- 
ample, £) separates characteristic from mantissa. 
“Cheque protection”: when position unused, fill with 
OFCL 3] (default 'x'). 

Conditional zero-fill: effect same as 0 for non-zero val- 
ues, but blank when value is zero. 
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a UFMT u 


2 3 I xa 


a 


Form of u: 


Form of a: 


A w 


q E wd 


q F wd 
qiv 


X p 
T p 


<text> 


q G<iext> 


KINI 


ty A 


NORD 
m 


M<text> 
N<text> 
P<text> 
Q<text> 
R<text> 


S<text> 


Format « according to a. 

Array of rank 0, 1 or 2. Vector u treated as l-col 
matrix. Alternatively, list of expressions separated by 
; and entire list surrounded by ( ). 

Character vector of format phrases with , as delimi- 
ter between adjacent phrases. 


Format phrases 

Character data. Print each character in field w wide. 
Exponential fraction. Total width w; d significant 
digits. 

Fixed-point fraction. Total width w; d decimal digits. 
Integer. Leading zeros blank unless Z qualifier used. 
Relative reposition. Start next field displaced P posi- 
tions from end of preceding. 

Absolute reposition. Start next field at position P 
(possibly over-writing preceding). 

Insert text in result. 

Picture. Insert successive digits of w rounded to near- 
est integer, at positions marked Z or 9. Z blanks lead- 
ing or trailing zeros. Sign may over-write background 
text. 


Key 

Number of repetitions (optional). 

Amount of positive or negative displacement. 

Field width. 

Number of decimal digits (in F format) or number 
of significant digits (in E format). 


Oualifiers (optional): 

Blank if zero. 

Comma insertion (not with G). 

Result scaled (10*e ) x value in u. 

Left justify digits (not with G). 

Print leading or trailing zeros. (N.B. with G format, 
Z within picture makes leading or trailing zeros 
blank.) 

To left of negative value. 

To right of negative value. 

To left of non-negative value. 

To right of non-negative value. 

Background. Text is cyclically repeated across the 
field, then overwritten by digits and decorators used 
to represent the value (and remains visible at unused 
positions). 

Symbol substitution. Ex: S<, .,> replaces comma 
by blank, decimal point by comma. 


Text-delimiting characters: 
Left text delimiter. 
Matching right text delimiter. 
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SYNTAX of OPERATORS 





Precedence: 


Valence: 


Argument type. 


Argument scope: 


Result: 


dfl: 
df2: 


Operators 


All operators: equal precedence. 
Any operator: higher than any function. 


Fixed (one argument or two arguments, de- 
pending on the operator). 


Array (i.e. valence 0) or function (valence non- 
0). 


Long left; short right. 


Ambivalent derived function, valence deter- 
mined by context. Abbreviations: 

monadic use of the derived function. 
dyadic use of the derived function. 


MONADIC 


When argument is a function (i.e. non-0 valence) 


f/[I]  Reduce 


Default axis: 


u. 
Result of dfl: 


Ex: 


filI)  Reduce 


Ex: 


JNLIJ Scan 


Applv f between adjacent subarravs along axis 
I of u. (When [I] is explicit, 570 is an implicit 
argument.) 


: Primitive scalar function (used dyadically). 


Where [I] elided, last axis understood. 
Simple array. 

Rank of 14ppu, with axis 7 eliminated, other 
axes unchanged. 
When 0=(54)[7]: Identity of f (see table, p. 4). 
X+2 3p16 | 1 2 3 


L E E 


FIIN — 5.7 8 
+/X — E 15 
+/10 = (e; 


Like f/, but default axis is first. 


+/X SS 


Multiple reductions. Consider u partitioned into 
subarrays, one for each position along axis Z. 
The result contains the f reduction of the first 
subarray, the f reduction of the first two subar- 
rays, and so on. The resulting subarrays are 
joined along a new Ith axis. (When [7] is ex- 
plicit, OZO is an implicit argument.) 


f: Primitive scalar function (used dyadically). 


Default axis: 
w: Simple array. 

Result of dfl. 

Ex: 


fX[I] Sean 


Ex: 


Where [7] elided, last axis understood. 


Array having same rank and shape as u. 


rary 


+NÍGI0X 1 2 3 
So ES 
+\X — 1 3 6 
4 9 15 
Like f N[ 7], but default axis is first. 
+X I 2 3 
SH 18 











and FUNCTIONS 
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Precedence. 


Valence: 


Argument type: 


Argument scope: 


Result: 


Functions 

All functions: equal precedence. 

Ambivalent (one or two arguments, depending 
on context). 


Array (i.e. valence 0). 


Long right; short left. 


Array (i.e. valence 0). 


OPERATORS / Z NY 


When argument is an array (i.e. has valence 0) 


j/{I] Replicate 


j: 
Default axis: 


u: 
Result of dfl: 


Ex: 
JACI) Replicate 
Ex: 
j\[I] Expand 
j: 


Default axis: 
u. 
Result of dfl: 


Fill element: 


Ex: 


jNLI] Expand 


Ex: 


j replications of each subarray along axis 7 of 
u. (When [7] is explicit, DIO is an implicit argu- 
ment.) 

Vector of non-negative integers such that 
pj + (pu)LI), or a scalar. 

Where [J] is elided, last axis is understood. 


Array. 

Array having rank 11 ppw, but axis I has length 
+/j. 

X+2 3p16 123 


4 5 6 


2 1/[070]X — 123 
1263 
4 5 6 


1 0 3/X > 1333 
4666 
Like j/[I], but default axis is first. 
1 24X —123 

4 5 6 

4 5 6 
Expand along axis J of w by inserting subarray 
of fill elements at each position marked by 0 in 
j. (When (1) is explicit, OTO is an implicit argu- 
ment.) 
Boolean vector (or scalar) containing 1’s such 
that +/j — (pw)[I]. 
Where [7] elided, last axis is understood. 
Simple array. 
Array having rank if ppu, with length of axis I 
increased by j+.=0. 
Numeric u: O. 
Character u: BLANK. 
Enclosed u: For the nonce, undefined. 
1 0 1NDIOJX + 1 2 3 


101001\X > 


E Hä FO 


oom CO 
Un OO 


00 3 
0056 
Like j\[I], but default axis is first. 
1 0 1X% <> 123 
000 
4 5 6 
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Axis 


ZK 


=> 


Implicit argument: 


dfl. df2: 


Note: 


alw] 


Sg: 


0.8 


g: 
dfl: 


Result: 
Ex: 


df2: 


S -s 


df2: 


Argument shape: 
Result: 


Ex: 


dfl: 


Argumenti: 


Result: 


DYADIC OPERATORS 


fog On 


df ranks: 


Ex: 
Ex: 


has S 


Composition of f on g. 
f: Ambivalent use of a primitive function (other than 
2). 
g: Monadic use of a primitive fn having defined argu- 
ment rank (see p. 8). 
Same as MR of g. 
For corresponding cells of a and u, 
(g a) f (g u) 
a +08 u 
$ +5> u 
and S is numeric scalar, matrix in which each row 


Select one axis k as f's axis of application. 

, © © or derived fn produced by 7 Å \ à. 
Integer identifying one axis of u to which the 
derived fn is applied. (Or. for lamination. a frac- 
tion differing from such an integer by an amount 
less than 1.) 

DIO 

Like f but with axis of application k. 


When the left argument is an array (i.e. has 
valence 0) [] is not an operator. See Selection 
by indexing, p. 7. 


f reduction of cells produced by executing g for 
each element of a cell of a with every element 
of the corresponding cell of u. 

Primitive scalar functions, used dyadically. 


Outer product 
Primitive scalar function, used dyadically. 
4 g W evaluated for each possible pairing of a 
cell 4 from a and a cell W from u. 
Array with shape (FS a), (FS w), SIR. 
2 30.*0 123 1 2 L 8 
do a 8727 
Undefined. 


Inner product 

Generalized matrix product 

a+.xw is ordinary matrix product. 

( 1tpa)zitpu. 

Array with shape ( 149a),14pu. 

For corresponding cells 4 from a and 4£ from 
w. each element of result is f/ å c.g K. 

In general. a f.g u — f/[cpa]SQa-e.g. 
where SekX-(coa)<Keir(pa),ou 








: 2 2 5 7x.*x3 2 0 1 506 
'BATES'+.='BEATS' « 2 
X+2 5: 'DICK CANET' 
Ve3 Sc'TOM DICK HARRY' 
XA.ZQY = 010 

0 G 0 

Generalized determinant 
Any simple matrix within the domains of f 
and g. 
Scalar computed by successive f reductions of l 
the g reductions of all possible vectors containing 
an element from each row and each column of 
Us- 

: “.xu Determinant of w 


Permanent of w. 


8 


t.Xu 


O 





Sum of logs of a and w. 
Where w is vector of enclosed vectors, 





~ 


elements of vector obtained by disclosing an 


element of w. 


Ex: 


dy]: 
Ex: 


a 502 u 
disclose of an element of a matches disclose of corre- 
sponding element of w. 

JS g u (same as fg) 


por UJ 


Boolean, same shape as a and u, 1 vyhere 





Where w is vector of enclosed vectors, 


result is a matrix, each row containing shape of dis- 


closed element of u. 


Dyadic Operators O o (continued) 





f Og Upon 


Composition of f upon g. 
f: Monadic use of a primitive fn (other than 2). 
g: Ambivalent use of a primitive fn whose relevant . 
argument ranks are defined (see p. 8). 


df argument ranks: Same as argument ranks of g. 


df2: 
Ex: 


For corresponding cells of a and u, 


fagu 


a Lö u Floor of the base-a logs of u. 


` dfl: For each cell of w, 


fok Rank 
f: 
k: 


Value of k: 


Ex: 
Ex: 


Ex: 


jeg Cut 


df]: 
Ex: 


With 
f: 
g 


fe 


: Argument rank: 


df2: 


Ex: 
Ex: 


djf1: 





ia Del u 


sp > u 


f g w (Same as fog u) 


Function f on rank-k cells. 

Ambivalent use of a primitive function (not +). 
Integer scalar or vector with (pk)<3. 

k specifies MR, LR, RR by 03p0k. 

Non-negative: number of trailing axes in argument 
cell. Negative: Complementary rank: |k is number of 
leading axes excluded from argument cell (i.e. frame 
rank). 

o Link corresponding vectors along last 
axes of a and u. 

Is each scalar in a a member of corre- 
sponding plane along last 2 axes of u” 
Add scalar from a to corresponding row 
of u. 

Enclose each vector along last axis of 


W. 


a €00 2 u 
a 400 1 u 


Kol w 


J-partitions of function g 

Scalar integer from 2 1012. 

Array selecting partitions from w. For j=0, each a-cell 
(4 in what follows) is a 2-row numeric matrix, one 
col for each axis of u. 

When j=0, each 4 is a Boolean vector whose 1s de- 
limit first-axis partitions of w. When a has multiple 
cells, all must call for the same number of partitions. 


: 4[1;J: offset along each axis to start of partition. 


1402; 1: shape of partition; where A[ 2; ]<0, same po- 
sitions selected, but in reverse order. 

positions in w corresponding 
included, when jso, excluded. 


j: Each 1 in 4 marks start of a partition; when j>0. 


to is in £ are 


j: Same as 1=|j, but each 1 in 4 marks end of a parti- 


tion. 

Monadic use of primitive fn having defined argument 
rank (see p. 8). 

Array in the domain of g. 


: Fn g is applied monadically to each partition of «. 


Result shape: (FS a), mp, SIR (where np is number 
of partitions; SIR is common shape of individual result 
on a partition of u). 

Only when jzo. Equivalent to df2 with o, =c 1 
DELIM, where DELIM is first subarray along the first 
axis of u when 1=|j, last when 2=|j. 

"ies ' ',u Enclose each word in text u. 


Dual of f with g. 
Ambivalent use of a primitive function. 


: Monadic use of a primitive function having defined 


argument rank and a defined inverse. At present, one 
of:< >* @~+-:2 
Same as rank of function g. 
For corresponding cells of a and u, 

gINV (ga) f (g o) 
a + © «  Antilog of sum of logs of a and «w. 
a „ >w Array same shape as a and «, each ele- 
ment containing enclosed array formed by catenating 
the disclose of corresponding elements of a and «. 
a, © u  Catenate along first axis. 
For each cell of u. 

BINV fgu 
X Array same shape as u, each element 
containing, enclosed, the shape of array enclosed at 
corresponding element of u. 
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DER 1514] 
S+JER IG] 
DER[ 25] 
QERI3:) 
QER(4;) 


a [SIGNAL u 


a DSIGNAL 10 
OSIGNAL w 


OEC 


0 
1 
Any error: 
ATTN: 
Interrupt: 
[TRAP 


Matrix TRAP: 
Vector TRAP: 


Fields 
NUMS 


RECOV 


U) 


[Nums] [0] 


[nums] [0] 


= 


6 [0] I 


(Nums) [0] E 


[nums] [0] C 


[NUMs] [0] D 


(RECOV) 


[RECOV] 


[RECOV] 


[EXIT | CLEAR] 


EVENT TRAPPING 


Event report 

Character matrix, 3 or 4 rows, set by system at, 
error or interrupt. 

4 OF EVENT NUMBER 

Event title. 

Line being executed when event occurred. 
Caret pointing to error. 

Name which lacks value. Row exists only when 
event 6 trapped with action Z. 


Signal 

Abort most recently started D input, 2, or defined 
fn. Signal event w with title a. 

When w empty, no effect. 

Same as a OSIGNAL w but with default title or 
none. 


Environment condition 

Conditions environment of defined fn to prevent 
it from being suspended other than by Sé stop 
control. Variable set by user and used by system; 
system resets to 0 when user sets invalid value. 
No effect. 

Default value when DEC localized but not set. 
Abort defined fn highest in si and signal error 
in environment that called it. 

Halt is delayed until exit from defined fn highest 
on SI. 

Treated same as error. 


Trap definition 

Variable set by user and used by system: system 
resets to '' when user sets invalid value. 

One line per definition. 

First character is delimiter: may not be a numer- 
al, -, or blank. 


Form of trap definitons 
Bracketed words optional. 
alternatives. 

Separated by blanks. 
Event-numbers of events to be trapped, sepa- 
rated by blanks. 

nl-n2 means all events in range al to m2 inclu- 
sive. 

0 means any event 1-999; 1000 means any event 
1001-1999. 

Where NUMS omitted, trap applies to all events. 
Own. Trap event only in function where local- 
ized, but not in functions invoked within it. 
Line to be executed when trapped event occurs 
(as if entered from keyboard following suspen- 
sion). 


| separates exclusive 


Stop 


Next. Look no further in this 
OTRAP, but move on to next (more 
global). 


Immediate. Execute RECOV (to pro- 
vide value for undefined name) and 
resume execution at point within 
line where error detected (i.e. re- 
sumes without + in RECOV). 


Execute RECOV. 


Cut back. Abort any functions later 
in SI than fn. to which DTRAP is lo- 
cal, and execute RECOV in that envi- 
ronment. 


Do action indicated by keyword 
(exit function, clear workspace, or 
do nothing). 





EVENT NUMBERS 17 


Any error (1-999: not in QER) 
WS FULL 
SYNTAX ERROR 
INDEX ERROE 
RANK ERROR 
LENGTH ERROR 
VALUE ERROR 
FORMAT ERROR 
RESULT ERROR 
DOMAIN ERROR 
SYMBOL TABLE FULL 
NONCE ERROR 
FILE TIE ERROR 
FILE ACCESS ERROR 
ILE INDEX ERROR 
FILE FULL 
ILE NAME ERROR 
FILE DAMAGED 
+ FILE TIED 
FILE SYSTEM HARDWARE ERROR 
FILE SYSTEM ERROR 
| FILE SYSTEM NOT AVAILABLE 
FILE LIBRARY NOT AVAILABLE 
FILE SYSTEM TIES USED UP 
FILE TIE QUOTA USED UP 
ILE QUOTA USED UP 
FILE RESERVATION ERROR 
FILE SYSTEM NO SPACE 
FILE COMPONENT DAMAGED 
WS LOCKED 
WS NOT FOUND 
WS NOT READABLE 
SWAP ERROR, CLEAR WS (Not trappable, but in DER) 
SYSTEM ERROR, CLEAR WS (Not trappable, but in JER) 
INTERFACE QUOTA EXHAUSTED 
NC SHARES 
+ INTERFACE CAPACITY EXCEEDED 
SHARE TABLE FULL 
PROCESSOR TABLE FULL 
IDENTIFICATION IN USE 
OPP ERROR 
DPW ERROR 
DIC ERROR 
DAL ERROR 
OC? ERROR 
DHT ERROR 
OPS ERROR 
UFC ERROR 
WS NOT WRITABLE 
1000 Any interrupt (1001-1999: not in QER) 
1001 STOF 
1002 ATTENTION 
1003 INTERRUPT 
1004 INPUT INTERRUPT 
1005 SV INTERRUPT 
1006 FILE INTERRUPT 
1007 FILE BACKUP INTERRUPT 
2001 Return to immediate execution (not in DER) 
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Abbreviations: Where the argument of a file function must have a 
specific form or content, rather than the symbols a or « for its argu- 
ments, the following more specific abbreviations appear: 





am Access matrix pc Permission code. 
an Account number.“ pn Permission number. 
cn Component number. tn Tie number. 

nm File name. * Different on PC. 


APL files on the PC: A user of SHARP APL/PC does not sign on with 
an account number, but is assumed to have account 3000 (or whatever 
number is specified in the U parameter to APL.BAT module SUPER), so 
the PC does not differentiate file libraries by account number. Functions 
which in SHARP APL/370 permit a file name to be qualified by its 
account number (e.g.' 7844929 WORK' OSTIE ) on the PC use the same 
syntax to specify the drive on which a file is mounted; drive A=1, 
B=2, etc. On the PC, eliding the number implies a file on the default 
disk, whereas on a timeshared system it implies a file in the user’s own 
private library. 


Since the PC is limited to a single task, share tie is no different from 
exclusive tie. File hold is meaningless (and is not checked for a valid 
tie number). Access matrices can be set, and work exactly as on a 
timeshared system, but since PC users don’t sign on with different 
numbers, references to other account numbers are generally meaning- 
less. 


TABLE OF FILE PERMISSION CODES 


1 DREAD, OSIZE 256 DRDAC, USTAC 
2 TIE 512 ORDCI 
4 DERASE 1024 GRESIZE 
8 [APPEND 2048 UFHOLD 
16 (REPLACE 4096 URDAC 
32 [DROP 8132 (STAC 
64 [HOLD 16354 JAPPENDE 
128 [RENAME 32768 (SIZE 
71 Gives unlimited access. 
Inquiry 
DAVAIL 10 File system availability 
1 Available. 
0 Not available. 

ULIB an File library. Available files of account 
an (* on PC, drive an) as 22-col. 
character matrix. Permission: any. 

DNAMES File names. Names of currently tied 
files. as 22-col. character matrix. Per- 
mission: none needed. 

[WUMS File numbers. Tie numbers of current- 
ly tied files as integer vector. Permis- 
sion: none needed. 

Existence 
nm DCREATE tn File create. Create file share-tied to 
tn with name nm. Permission: none 
needed. No result. 
mm: Character vector, 3 fields separated by 
blanks: 
1 an.” Optional; not an of another user 
(370) or of unavailable drive (PC). 
2 Name. Max 11 chars (370) or 8 chars 
(PC). 
3 Optional: file size limit in bytes. 
nm LIRENAME rel. en Rename file tied to fm so new name is 
nm. Fields of nm same as for 
DCREATE, (* on PC, new name may 
not imply different drive). Permission: 
128. No result. 
nm (ERASE tn[,pn) Erase file tied to tm whose name is 


am. Permission: 4. No result. 





SYSTEM 
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Linkage 
nm USTIE tn[,pn] 


nm [TIE tn[,pn] 


QUNTIE tn 


Description and limits 


ORDCI tn, eni, pn) 


UO N — 


USIZE tni,pn) 


BUN 


a URESIZE tn[,pn] 


Access 
URDAC tn[,pn] 
am OSTAC tn[,pn] 
am: 
Hold 
DHOLD tn 


UFHOLD u 


Use 
DREAD tn, cn[, pn] 


Share tie. Tie to tn file named nm (on 
370, permitting other users to share- 
tie also). Permission: any. No result. 


Exclusive tie to tn file named am (on 
370, for exclusive use by this task). 
Permission: 2. No result. 


Untie. Release files tied to tie num- 
bers tn. Permission: none needed. No 
result. 


Read component information for com- 
ponent cn of file tied to tn, 3-element 
vector. Permission: 512. Elements: 
Size in bytes. 

an of task which wrote current value. 
Time written (60ths of sec. since 
1960-3-1 0:00:00). 


Size of file tied to tn as 4-element 
numeric vector. Permission: 1 or 
32768. Elements: 

cn of first component. 

cn of next component to be appended. 
Space now used, in bytes. 

Size limit, in bytes. 


Resize. Set to a size limit of file tied 
to tn. Permission: 1024. No result. 


Read access matrix of file tied to tn; 
three cols: an, pc, pn. Permission: 256 
or 4096. 


Set file access to am for file tied to 
tn. Permission: 8192 or 256. No re- 
sult. 

3-col. matrix, same form as result of 
DRDAC. 


File hold. Delay OHOLD or DFHOLD by 
others to files tied to tn, until next 
OHOLD, DFHOLD, or return to immedi- 
ate execution. (* On PC, no effect.) 
Permission: 64. No result. 

Same as OHOLD, but optionally with 
matrix w, passnumbers as second row. 
Permission: 2048. No result. 


Read data object in component cm of 
file tied to tn. Permission: 1. 


a [REPLACE tn, cn[, pn) Replace component cn of file tied to 


a DAPPENDR mi, pn] 


Result: 


a QAPPEND ml, pa) 


DODROP tn, nf, pn] 





tn with data object a. Permission: 
16. No result. 


Append with result. Write new compo- 
nent containing data object a in file 
tied to tn. Permission: 16384. 

cn of appended component. 


Append. Effect same as QAPPEND, but 
no result. Permission: 8. 


Drop |m components from file tied to 
tn. n>0: drop from beginning; nco: 
drop from end; cm of remaining com- 
ponents unchanged. Permission: 32. 
No result. 
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[JRUNS Task information. Integer matrix, one row per task 
(on IBM PC, necessarily limited to one row). First 
row: current task. Column: 
Task ID. 
Account number of task's owner. 
Account number of task's initiator. 
O Task S-task, or PC. 
1 N-task 
2 B-task 
CPU units used since start of task. 
Elapsed seconds since start of task. 
Task s CPU limit in units. 0 
Task's connect limit in seconds. 0 





U 
morn 


EON o 
U 
o 
o 


OD 4 ON U 


OBOUNCE w Bounce. Terminate tasks identified in w. 
Domain: Numeric vector, IDs of tasks running on or initiated by 
your account. 
Result: Boolean vector, 1 where termination request is valid. 


T-TASK: Terminal on time-shared APL 


Initiate. Transmit to terminal-controller: 
O)cR ASCII (assumes local display of input). 
OE)cR ASCII; start echoed display of input. 
OL)cr ASCII; start local display of input. 
OB)cr ASCII; bulk input using XON/XOFF flow control. 
9)cR IBM correspondence encoding. 
Jcr IBM BCD encoding. 
Response: System transmits blot 
Sign on: )acctno : passwd 
Control: Immediate execution of keyboard entries. 
Terminate. )OFF | HOLD] I: passwd} 
)CONTINUE [ HOLD] I: passwd} 
Disconnect communications link. 
OBOUNCE task-ID 


N-TASK: APL task without terminal 
URUN u Start N-task 
Domain: Character vector, five fields separated bv blanks: 
signon: Must include colon: eliding account number and pass- 
word implies your own. 
loadws: For autostart: Name of ws. 
For split-ws: Colon. 
savews. Name to be assigned to ws when saved at termination; 
may not be elided. 
maxcpu: Maximum CPU units for task, 0 means no limit. 
maxsecs. Maximum elapsed seconds for task, 0 means no limt. 
Result: Two-element numeric vector. 
0 0 Task started (visible only in spawned ws). 


0 n Task n successfully started 

1 n w invalid at character n. 

2 0 System capacity for N-tasks exhausted. 

(On the PC, no other result possible. ) 

3 0 Owners N-task quota exceeded. 

4 O Owner's ws quota insufficient to save savews. 
5 0 Workspace full in loadws. 

6 0 Symbol table full in loadws. 
10 0 Sign-on number not in system. 

11 0 Sign-on number locked out. 
12 0 loadws not found. 
13 O loadws has invalid OLX. 
14 0 System capacity for tasks exhausted. 
15 0 User may not use ỌRUN. 
16 0 Hardware error. 
Only for tasks started by B-task Scheduler 

58 0 OSP too large. 

59 0 No ws saved by crash recovery program. 
60 0 Unable to start B-task in NBBTASK spec. 
61 0 Unable to complete sort in NBSORT spec. 
62 0 Task not restartable, ABNORMRST not specified. 
63 0 Error in processing specs. 





B-TASK: Enqueue batch APL tasks 21 


Submit B-task requests via functions in ws 1 BTASKREQ. 





BTSUBMIT u B-task request 
Domain u: Character vector of DRUN arguments: optionally 
preceded by processing specs, separated from 
each other by , or blank, and from QRUN argu- 
ments by o. 
Processing specs 
NORMRST Restart OK after normal shutdown. 
ABNORMRST Restart OK after system crash. 
NBTIME(HH:MM [HH:MM]) Not earlier in day than indicated UTC 
time (optionally, nor later than follow- 
ing time). 
NBDATE(MM/DD/YY) Not before indicated UTC date. 
NBTS(YYYY/MM/DD HH:MM) Not before indicated UTC date and 
time. 
NBBTASK(NNN) Not before termination of B-task NNN. 
NBSORT(NNN) Not before successful termination of 
sort NNN. 
NBOR(msg) Not before Operator permits (accord- 
ing to text of msg). 
COPYSP Copy value of OSP from requester’s ws 
to B-task's ws. 
NTASK Run as an N-task 
Result: Request-number, or 0 if invalid. 


BTASKREQ B-task request. Prompts for specs and DRUN pa- 
rameters, then submits B-task request. 
Result. Character vector showing request number, date 
and time of request. 


BTWITHDRAW reqnos Withdraw indicated B-task requests. 
Result: Boolean vector, 1 where request withdrawn. 


BTINQ reqnos B-task inquiry regarding regnos 

Result: Four-col. matrix, 1 row per request. 

Col. 1: Request-number. 

Col. 2: Status of request. 

0 Not on file. 
Queued. 
Active; col. 4 contains task-ID. 
Successfullv started, no longer active. 
Withdrawn. 
Svstem error. 
Failed. Description in cols. 3-4. 
Cols. 3-4: Result of QRUN received by B-task scheduler 
when it started the task. (See DRUN, p. 20.) 


om E co Nr 


BTDISPLAY reqnos Inquiry display 
Formatted description of requests in regnos, 
same status codes as BITING. No result. 


Report request numbers 

Each returns numeric vector of request numbers: 
BTREQUESTS BTQUEUED BTACTIVE 
BTFAILED BIWITHDRAWN BTCOMPLETED 
BTLAPSED (i.e. BTCOMPLETED, BTFAILED, BIWITHDRAWN) 
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S-tasks described using 0-origin. 
Initiate. 1 OSVO shv Share shv with AP-1. AP-1 requires 
(pshv)<23. 
shvHjavlo 0 0 0],')! 
Response: AP-1 sets shy to blot. 
Sign on: shvHJAVLO 0 0 0],')',an,':',passwd 
(passwd optional if an is your own) 
Control: S-task executes line transmitted via shv. 
Terminate. Any of: shv-DAV[0 0 0 0], ')OFF' 
DBOUNCE task-ID. 
Retract shv without permission. 





Prefix codes sent to AP-1 


Input to APL system: DAVLO 0 0 0],text 
Request accounting: DAV[0 0 1 0] 
ATTN/BREAK: DAV[O 0 2 0] 
Request permission to retract: QAVLO 0 3 0] 
Cancel permission to retract: DAVLO 0 4 OJ 


Segmented transmissions from AP-1 

Sample program to separate segments from single value of shr: 
S+shv Don't re-use shv until ready. 
JEXTEW 

REPEAT: L+25610AV12+5S Gross length of segment. 
PREFIX+4t2+5 
TEXT+TEXT,6+L+S 
S+L+S Remaining segment(s). 

2(02pS)/REPEAT 


Prefix codes received from AP-1 

DAV[0 0 1 0] Preceding entry invalid. 

DJAVLO 0 2 0] APL lacked space to process preceding entry. 

QAVLO 0 3 0] S-task not signed on. 

GAV[0 0 0 x] Preceding entry accepted. Fourth byte describes ac- 
companying text and/or S-task's state. 


Interpretation of 1 in binary representation of prefix 3] from AP-1 
MODE- (862) TOAV1PREFIX( 3] 

MODETOJ S-task in immediate execution mode. 

MODE[1] Accompanying text is blot. 

MODE[ 2] S-task not signed on. 

MODET3) S-task keyboard locked; ATTN to request input. 

MODE[u] Reset S-task cursor to next-line margin (following ATTN). 

MODE[5] Arbitrary I/O (accompanying or expected). 

MODE[6] Accompanying text is prompt for input. 

MODE[7] Accompanying text is output (more or prompt to come). 


Common values of PREFIX[3] received from AP-1 

00000001 1 Normal output, more to come. 

00000010 2 Normal output, final (i.e. prompt for T 
or V-editor input). 


00000100 4 QARBOUT or [JARBIN, more to come. 
00000101 5 DARBOUT, final. 
00000110 6 DARBOUT prompt for QARBIN. 
00001001 o APL requests cursor reset. 
00010001 17 S-task ready for input but keyboard 
locked, awaiting ATTN. 
00100000 32 S-task not signed on to APL. 
01000001 65 Part of a blot; more to come. 
10000010 130 Prompt for immediate-execution input. 
11000010 194 Blot prompt for immediate-execution in- 


put. 
11100010 226 Sign-on blot prompt. 


GAV[2] during input to an S-task is treated as TAB. That is, it is 
replaced by some number of blanks, depending on the value of DHT in 
the S-task’s ws and the position in the text at which it occurs. 
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smnl Matrix name list with surrogates. A character matrix each 
row of which contains one name (or, optionally, a name and 
its surrogate name). Where a row of smni contains two names, 
the name on the left is the name in the offerer’s ws, and the 
name on the right is the surrogate name offered to the partner. 
When u contains a single name (or name and surrogate), it 
may be a vector; for a one-character name, w may be a scalar. 
When smal refers to a variable that is alreadv shared, the 
surrogate name need not be restated, but if included must be 
consistent with the original offer to share. 





OSVQ w Shared-variable querv 
DSVQ 10 2-col. matrix of processor ID and clone ID, one 
row for each processor which has unrequited 
offers to you. 
OSV2 w When w not empty, it must identify one proces- 
sor (2-element vector of processor ID followed by 
clone ID, or scalar or l-element vector for clone 


ID 0). 
Result: Matrix of names offered to vou bv processor 
2tw. 
USVS smal Shared-variable state 


Result: 4-col. Boolean matrix, one row per name in smal 
(or 4-element vector). 
0 0 1 1 You and partner are both aware of current value 
(and SV processor is not). Initial value when 
name first shared. 
You have set, but partner has not used. 
Partner has set, but you have not used. 


o r 
PO 
or 
Ho 


OSC State-change variable 

Value: While workspace has valid clone ID: scalar 1. 
Otherwise, 0. 
System interlocks [DSC so you cannot re-use [SC 
until system has set it. System sets your OSC to 
1 following each event outside your ws which 
affects any variable you are sharing, including 
retraction, change in its state, set of QSVC, or 
any new incoming offer. 


a OSVO smal Shared-variable offer 
Offer to share each name in smal with corre- 
sponding processor identified in a. 
a: 2-col. numeric matrix, processor 1D followed by 
clone ID, having a row for each row of u, or a 
single row for all. May be vector (but only of 
length 2) treated as 1 2pa, or a scalar, treated 
asi 2pa,0. 
smni: Where a row of smal contains two names, the 
name on the left is the name in the offerer’s ws, 
and the name on the right is the surrogate name 
offered to the partner. 
Result: Degree of coupling following offer. 
OSVO smal Degree of coupling. 
0 No coupling; not a well-formed name. 
You have offered but partner has not accepted. 
2 Sharing in effect. 


a USVC smal Shared-variable control 
a: Boolean, 4-col. matrix (or may be 4-element vec- 
tor if w has only one name), or scalar. 
Result: Access control in effect following execution. 
1 INHIBITS 


Partner 
has 
used 
or set 


H 











OSVC smal Report shared-variable control. 
Result same as for a (SVC smal. 


OSVN u Set or report clone ID 
If possible, sets clone ID to w. 

Result: Clone ID in effect following execution. Since 
clone ID cannot be negative, negative u reports 
current value. When no valid clone 1D has been 
set, result is 1. 


OSVR smni Shared-variable retract 
Result: Degrees of coupling before retraction. 
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€ 
An auxiliarv processor (AP) is a program independent of APL, but 
active at the same time as APL, and able to share a variable with the 
active workspace of an APL task. All communication with APs goes 
through the shared variable processor (SVP). (On the PC, SVP, fol- 
lowed by the particular APs you expect to use, must be started at the 
same vou start APL; their invocation and parameters mav be included 
in the BATch file that starts APL.) 


Communication is initiated when an APL task offers the name of a 
variable it proposes to share with a specific AP; in the offer, the AP 
is identified bv its processor ID, a scalar integer less than 1000 and 
greater than 0. The offer may be accepted, provided the AP in question 
is in fact installed and running, has capacity to accept an offer, and 
(for certain APs on a timeshared system) provided the user has previ- 
ously been granted access to it. APs commonly available for installation 
with SHARP APL are listed here. Users of SHARP APL/PC may also 
write their own APs: see SHARP APL/PC Handbook. 


Sys- Auxiliary Processor 

tem ` up Description 

370 1 APL. Permits starting an S-task: a distinct APL task con- 
trolled via the shared variable (rather than from a key- 
board). See pp. 22-23 of this booklet, or SATN 39. or 
SHARP APL Reference Manual. 


370 4 AVAM. Access from an APL task to VTAM, permitting 
access to TSO, CICS, etc., or to application programs such 
as IMS, IDMS, etc. See ch. 7 of SAPLAP.* 


370 123 VSAM. Access to VSAM files (under MVS) following con- 
ventions of IBM's AP123. See ch. 9 of SAPL-AP* or the 
IBM terminal user's guide appropriate to the host system 
under which APL is running. 

PC and 

370 124 FSCR. Full-screen manager for textual displays, following 
conventions of IBM's AP124. For 370, see SATN 47: for PC, 
see SAPL/PC Handbook. 


370 126 GDDM. Full-screen manager including graphics. following 
conventions of IBM's AP126 GDDM. See SATN 47. 


370 370 TSIO. Access to OS datasets via QSAM and BDAM, un- 
der MVS, and ability to pass modified subset of JCL to 
MVS. See SHARP TSIO Users Guide. 


370 541 FCAP. Invoke functions written outside APL (e.g. in 
FORTRAN, COBOL. assembler, etc.) and return results to 
APL workspace. See ch. 8 of SAPLAP.* 


PC 700 ACOM. Asynchronous communications to external devices 
(such as terminal, printer, plotter, timeshared APL system) 
following RS232 protocol. See SaPL/PC Handbook. 


PC 710 DOSX. Communication with PC-DOS for DOS commands, 
function calls, and access to native files. See SAPL/PC 
Handbook. 


* System Programmers Guide: SHARP APL Auxiliary Processors, 
I.P. Sharp Associates: Toronto, 1983. 
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Package: Variable containing a set of names and the referent of each 
name, which may be a function, a variable (including a package), or 
undefined. l 
Abbreviations: Where the argument of a package function must have 
a specific form or content, rather than the symbols a or w for its 
arguments, the following more specific abbreviations appear: 





p Package. sn Single name (character vector or scalar). 
pl Package. , mni Matrix namelist, one name per row. 
p2 Package. nl Namelist. May be mal or vector (or scalar) with 


names separated by blanks. 


OPNAMES w Package names 
Names in package w as mal. 
When w is not a package: empty vector. 


ni DPNC p Package nameclass 
Class, in package p, of names in ni. 
OPNC u +> (DPNAMES p) DPNC p 


Result: Integer vector, one element per name: 
“1 Name present with no referent. 
Name not present. 

Name present; referent is a variable. 
Name present; referent is a function. 
Not a well-formed name. 


E oO hä O -K 


ni UPLOCK p Package lock 
Package identical to p but with fns. named in 
al locked. 
UPLOCK p ((3=0PNC p)ADPNAMES p) DPLOCK p 


ni OPSEL p Package select 
Package containing names from ni and the refer- 
ents those names have in p. 


ni OPEX p Package expunge 
Package identical to p but excluding names from 
nl and their referents. 


p2 UPINS pl Package insert 
Package in which names and referents of pack- 
age pl replace or supplement those of package 
p2. 


sn DPACK w Pack 
Package containing name from sm and the val- 
ue u as its referent. 
UPACK al Package containing names from al and whatever 
referent each name has in the visible environ- 
ment. 


sa OPVAL p Package value 
Value in p of variable named in sa. 


nl OPDEF p Package define 
Visible referents of names from nl are replaced 
by referents those names have in p. No result. 
OPDEF p (OPNAMES p) DPDEF p 


nl UPPDEF p Protective packaged define 
For names in al which have no visible referent, 
define referents from package p. 
UPPDEF p (OPNAMES p) OPPDEF p 
Result: Matrix of names not defined because of visible 
use in the Ws. 
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WORKSPACE REPORTING 





UV E © 


mnl 


ni 

sn 
WA 
[WS w 
WS w 


SMP 

EEE 

nu E 
NDH 


U 


[WS sn 
[WS al 
[WS al 


[WS sn 
ONC mal 


[WL u 
ONL w 


Matrix name list. A character matrix each row of which 
contains one name: mav be a vector (or scalar) provided 
argument is limited to a single name. 

Namelist. Vector (or scalar) of names separated bv 
blanks, or mal. 

Single name (character vector or scalar). 


Work area. Number of bytes available in active ws. 
Workspace information. a selects description: 


Namelists. Names of visible objects in class w, character 
matrix, alphabetized. «: Sum of any subset of 1 2 4 8. 
1 Function. 
2 Variable. 
4 Group. 
5 Label. 
Workspace description. u selects description: 
Workspace 1D as character vector. 
State indicator as character matrix. 
WS environment as 12-element numeric vector: 
1-5 Unused (value 1). 
6 1 in ws recovered following crash of timeshared 
system; 0 otherwise. 
7 Max number of entries in symbol table. 
8 Actual number of entries in symbol table. 
9 Account number of owner of this task (same as 
11047). 
10 Task's port number. 
11 Task ID. 
12 Terminal transmission encoding: 
o None (N- or B-task). 
IBM Correspondence. 
IBM BCD. 
ASCII without APL 
ASCII with APL (typewriter-pairing). 
ASCII with APL (bit-pairing). 
Unused (intended for Telex). 
None (S-task). 
None (PC). 
Workspace information (like 20.) as 3-element vector: 
WS size (bytes in use) 
2 Account number of task which saved ws. 
3 Timestamp (60ths of a second since 1960-03- 
01 00:00:00). 


M NJ Om F UN F 


— 


Members of group named in sm, as character matrix. 
Storage space in bytes for each object named in nl. 
Nameclass of each object named in ni, as numeric matrix, 
one row per name, one column per sı level, and last col- 
umn for global environment: 

1 Not localized at this level. 
Undefined (but localized). 
Function. 
Variable. 
Group. 

5 Label. 
Value of variable named in sa. 


F no 


Nameclass of each name in mal. 
0 No visible use (vvell-formed name). 
1 Visible use as label. 
2 Visible use as variable. 
3 Visible use as function. 
4 Other (including ill-formed name or use as 
name of group). 


Namelist of objects in any of classes in numeric vector 
u, aS alphabetized character matrix. 

Same as OXZ but limited to names whose first character 
is member of vector (or scalar) a. 






mE om 








i 


mm MM 


SYSTEM REPORTING 27 
DISA ER INE. 0 


DAT 


NO O0 HIN U B UND = 


UTS 


DUL 


Account information. 9-element integer vector. 
Account number of task's owner.(PC : 3000) 

CPU milliunits this task. 

Elapsed milliseconds this task. 

Keying milliseconds this task. 

I/O characters this task. 

CPU milliunits, cumulative.* 

Elapsed milliseconds, cumulative.* 

Zero (unused). 

Characters transmitted, cumulative.* 

On timesharing systems, cumulative T-task and S-task usage 
since last billing. On pc, same as for current task. 


Timestamp. Current time and date as 7-element integer vector: 
year, month, day, hour, minute, second, and millisecond. 
Timezone: as set by computer centre; I.P. SHARP ASSOCIATES 
timesharing service uses UTC. (On PC, depends on time provided 
by Dos, and whether clock maintains time over poweroff. ) 


User load. Number of tasks currently running. 


I-Beam Functions 


In APL\360, a miscellany of system-reporting functions was provided 
by the catch-all function 1, named ''l-beam'. This family of functions 
was subsequently withdrawn from IBM APL systems. SHARP APL 
continues to tolerate 1, but it is considered obsolescent: descriptions are 
included here mainly to help interpret existing programs that still use 


I. 
£19 
120 
I21 
I22 


I23 
I24 


I25 
126 


I27 
128 


T29 
6I11 


6111 
6111 


6111 


Keving time in sixtieths of a second. Cumulative time 
since start of task during which it has been available for 
input. Approximately DAI[4]x60+1000. 

Time of day, in sixtieths of a second since 0:00:00 of 
the dav on which the task started. 

CPU units, cumulative since start of task, in sixtieths of 
a unit. Approximately DA7[2]x60+1000. 

Work area. Remaining free space in the active work- 
space, in bytes. Equivalent to [WA. 

User load. Number of current tasks. Equivalent to DUL. 
Sign-on time, in sixtieths of a second since 0:00:00 of 
the day when the task started. 

Sign-on date. Calendar date at start of the task. encod- 
ed as 1001M, D, 100|Y. 

Current line. Equivalent to *'p1+DLC. 

Line counter. Equivalent to DLC. 

Session management. encoded as: 


1 N- or B-task. 

0 S-task (including IBM PC). 
1 IBM 2741 Correspondence. 
2 IBM 2741 BCD. 

5 ASCII. 


Account number. Equivalent to ''pDAT. 


O Walkaway. Condition the current active workspace so 


that it will sign off the task with )CONTINUE HOLD at 
next return to immediate execution. Result: 0. At 
present no equivalent OTRAP setting. 


1 Comeback. Nullify earlier 6111 0. Result: 0. 
2 Clearout. Condition the current active workspace so that 


it will execute )CLEAR at next return to immediate exe- 
cution. Result: 0. Equivalent to 
OTRAPE'n 2001 D CLEAR". 


3 Noclear. Nullify earlier 6111 2. Result: o 
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DLOAD u 
OQLOAL u 


ILXEw 


OSP+w 


ODL w 
OLE 


UCR u 


OFX u 
Result: 
DEX mal 
Result: 

a DFD w 
1 DFD sn 


2 UFD sn 
3 DFD w 


Result: 


6 DFD al 


Result: 
7 QFD al 
Result. 


Load ws identified in character vector u. No result. 


Quiet-load ws identified in character vector u (i.e. without 
displaying save-date). No result. 


Latent expression. System automatically executes GLX fol- 
lowing each load (but not )XLOAD). Value in clear ws: 


tt 


Session parameter. Value at start of T-task or S-task: 
tt, In SHARP APL/370 (but not in SHARP APL/PC), 
folloving a load or clear, the system copies the value of 
DS? from the preceding active ws to become the current 
OSP. N-task starts with parent's QSP; B-task does so only 
when its specs include COPYSF. 


Delay at least « seconds. Result: actual delav. 


Line counter. Numeric vector identifying line being exe- 
cuted or at which execution is suspended. for each level 
of SI, most recent first. + or G represented by number of 
line which invoked it: immediate execution represented by 
0. 


Canonical representation of function named in c, as char- 
acter matrix, without line numbers or V. 


Fix function from (matrix) canonical representation «. 
Success: Name of the function thus fixed. 
Failure: Line number of line in error. 


Expunge. Free visible use of names in « (provided not in 
SI). 
Boolean vector. 1 where name free following execution. 


Function definition. o selects aspect: 


Representation of function named in sm. as character vec- 
tor, including line numbers. CR between lines. opening and 
closing $. 
Representation of function named in sn, as matrix without 
line numbers or V. (Same as JCZ.) 
Fix function from vector or matrix representation of u. 
Function name must not occur in SI. 
Success: name of function thus fixed. 
Failure: 2-element numeric vector. Second element: line 
in error. First: diagnostic code: 
Workspace full. 
Definition error. 
Character error. 
Symbol table full. 
Unmatched quote. 
Unused. 

7 Empty line. 
Free visible use of names in al (by expunging those in use 
but not in SI). 
Matrix of names from al nor free following execution. 
Lock visible definitions of functions named in w. 
Character matrix, names in w whose visible referent is not 
a function. 


na E UN 
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m 
Lew 


fa 
at 


Result: 


Few 


a+T 


Result: 


PW +m 


Valid: 
Default: 


SECH 


Valid. 


Default: 
PC: 


FI u 


Result: 


— p q 


avi b 


Result: 


— < 


Quad output. Display pending T output (if any), then u. CR. 
Subject to ZFF. DSW. LEE. 

Quad input. System prompts by transmitung Z: then 4 
blanks then LF (to position cursor at position 7 of following 
line). 

Value obtained by evaluating next line entered. 


Quote-quad output. Display u, but followed by CR only 
when returning to 0 or immediate execution input. Subject 
to OPW. OPF, DPS. System buffers last line of output from 
successive uses of ™ until any of: 

Amount buffered exceeds GW: 
or Output via Z or JAPEJUT: 
or Return to immediate execution. 


Quote-quad input. System prompts by transmitting buffered 
line of T output (if any). and awaits (on same line) one line 
of entry from keyboard. 

Character vector merging last line of T prompt (if any) and 
characters entered in response. 


Print width. Maximum characters displayed before system 
folds line. 

Integer scalar. not less than 30 nor greater than 250. 

In clear ws in SHARP APL/370, 132; in SHARP APL/PC. 
80. 


Horizontal tabs. Number of positions each stop is displaced 
from left margin. At each load or clear, system copies 
visible DAT from preceding active ws to become visible JET 
of active vs. 

Strictly increasing vector. or scalar (implying equally 
spaced stops). 

At start of task: 10. 

Value of ZAT is ignored. (The TAB key of the PC generates 
8 blanks. regardless of cursor position when it is pressed. ) 


Field input of characters representing numeric data. Fields 
separated by blank(s). 
Numeric vector, value of each field in character vector u. 
Non-numeric field: 0. 


Validate input of characters representing numeric data. 
Boolean vector. For each field in character vector u. + 
where the field contains a well-formed number representa- 
uon. 
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DOUT w Record session I/O to file and/or display. 
w: Integer vector. empty or 2 elements: 





w[1]: 0 No display. 
1 Display (during T-task; to shy during S-task). 
w[2]: 0 No append. 


n Append output to file tied to a. 
Result. u empty: Current setting. 
w not empty: Former setting. 


Control messages 

While copying display to a file, DOUT may generate control messages 
to describe the circumstances of input or output. Messages which may 
arise as side-effects of using DOUT are marked * in the following list. 
These control messages are recognized and interpreted by the HSPRINT 
facility of SHARP APL/370. HSPRINT also recognizes certain other mes- 
sages that control aspects of printing not relevant to terminals and not 
generated by DOUT; such additional control messages may be explicitly 
appended to the file, or generated by utility functions provided in 370 
ws 1 HSPRINT. 


Form: 22-element character vector: 





I 1+DAV. 
2-5 Message number with leading zeros. 
6 BLANK. 
7-10 Component count. 4-digit number with leading zeros: num- 
ber of following components to which message applies. 
11 BLANK. 
12-22 Mnemonic (for readability; ignored by HSPRINT). 


List of control messages 


0000 FORMAT * Arguments to GFMT follow. 

0001 MIXEL * Mixed output follows. 

0002 PAGEN New page number follows. 

0003 QUADP *T output follows. 

0004 TRANSLATE Translate table follows. 

0005 DIGITS New value for 277 follows. 

0006 WIDTH New value for CW follows. 

0007 TITLE Page title follows. 

0005 SUBTITLE Page subtitle follows. 

0010 PRTUCTM Boolean switch follows. for printing of user 
control messages. 1 means print: 0 (default) 
means ignore. 

0011 PAGE Skip to beginning of new page. 

0012 CARRIAGE Vertical forms control follows. 

0013 PRTARBOUT Boolean switch follows. for printing of ARBOUT 
data. 1 means process: 0 (default) means ig- 
nore. 

0014 ARBOUT * JARBOUT argument follows. 

0015 ARBIN * JARBIN prompt and result follows. 

0016 PRTARBIN Boolean switch follows, for printing of ARBIN 
data. 1 means print: 0 (default) means ignore. 
Switch to printing/no printing of ARBIN data. 

0018 HFILE File created by ASPRINT. 

0015 QUAD ER $ JEK follows. 

0020 INPUT * Normal input follows. 

0021 QUAD * input follows. 

0022 QUAD PRIME *T input follows. 

0023 FN DEFN * Function definition input follows. 

0024 WS FULL *ws full preparing input. 

0025 ST FULL * Symbol table full preparing input. 

0026 DEFN ERR * Definition error preparing input. 

0027 NOT IN DEFN “Input not allowed in defn mode. 

0028 OPEN QUOTE “Input contained unmatched quote. 

0029 PRTINPUT Boolean switch follows, for printing of kev- 
board input. 1 means print; 0 (default) means 
ignore. 

0030 QUADFS New value for 575 follows. 

0031 CHAR ERROF * Character error while preparing input. 


mm Hm HHH ME HH HE ër ë 
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Output To 


central printer; to remote printer; to tape: to APL file (with 


each page image a component). 


Input: 


File(s) containing data to be printed and also control 


messages and their arguments. 

Acceptable data: APL arrays; formatted like terminal output, subject to 
QUADPS, WIDTH and DIGITS. May contain CR, LF, or BS. Arbitrarily 
re-settable translate table maps DAV to available printer characters. 


Functions to prepare control messages 
Each appends control message to file tied to tn. 


a DIGITS tnSets [PP to a. Default: 10. 


WIDTH tn 
a TITLE tn 


D 


a SUBTITLE tn 


Sets DPW to a. Default: 132. 
Character a sets text. Default: account number and times- 
tamp. Boolean a: 1 print; 0 no print: default: 1. 


Character a sets subtitle; Boolean a: print or noprint: 
default: 0. 


a CARRIAGE tn Boolean vector; pa «> Total lines before next TOP OF 


a PAGEN tn 


PAGE tn 


a PRTINPUT tn 


a HSP w 


a. 


tn<0: 
tn=0: 


Gj. 
delivery: 
printspecs: 


Destination: 
Train: 
Copies: 
Density: 
Form: 
Separation: 
File tie: 
Disposal: 
Mode: 
SHOW: 
HELP: 


Effect: 
Result: 
aso: 
MINE 
WITHDRAW u 
SHOW u 


u. 


STATUS u 


w! 


HSPINQ w 


FORM: output to lines marked 1. Default: 6611 0,5801. 

Control page numbering. Boolean 1ta inserts current PNO 

at right end of title; optional second element: sets PNO. 

Default: 1 1. 

Next output line at TOP OF FORM. 

Boolean a controls printing of input components writ- 

ten by DOUT. Default: 0 (no print). 

*For arbitrary I/O, user-defined control messages, or non- 
default translate tables, see SATN-8, HSPRINT. 


Highspeed print request 
Vector (or scalar): tn(s) of files as single job. 
Matrix: One row per file; up to 4 cols: 

I tn to which file now tied. 

2 pn with which file now tied. 

3 Access: 1 Stops HSP from setting access matrix. 

0 Permits HSP to set access. 

4 pn for 1000 to tie file (when 1 in col. 3). 
Verifies validity of w but does not submit request. 
Prompts for tn of file(s) to be printed. 


'[ printspecs o | delivery * 
Text to be read by staff where printed. 
Up to nine fields with , as separator, any order: 


Default 

PRINTER | FILE | REMOTE (node) | TAPE( parms) 
FAST | FULL | PN2 | APL | APLF 

DO1 | DON (where n is 1-9) 

6LPI | 8LPI 

STD1 | STDn | ULDn | CONn | REV1 | PRIV 


NODECOLLATE | DECOLLATE 


UNTIED | TIED (following request) 
NOERASE | ERASE (following printing) 
QUIT | SHOW | HELP 


Interactively verify or abort request. 
Display options, remote locations, tape parameters. 


Request HSPRINT facility to print the indicated file(s). 
Request number and timestamp, as character vector. 
For invalid w, numeric index to matrix HSPERRORS. 
When submission aborted: empty vector. 

w if valid, or numeric error code. 


Reporting functions 

Vector of request numbers of recent requests. 

Remove from queue any unprocessed requests in numeric 
vector w. Result: numbers successfully withdrawn. 
Report on requests identified in u, as character vector 
including CRs, requests delimited by c. 

Numeric vector of requests, or 'RECENT' or "ALL". 
Status of requests identified in w, as character vector with 
requests delimited by CR. 

Numeric vector of requests, or 'RECENT' or 'ALL'. 
Status of requests w as 2-col. numeric matrix. First col: 
request. Second: sum of status codes: 

1 PROCESSED 8 IN PROCESS 64 RE-HREQD 

2 ERROR SEEN 16 TRANSMITTED 128 CANCELLED 
4 WITHDRAWN 32 SUBMITTED 
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[AV Atomic vector. Vector of all 256 unique characters in order of 
internal representation. Whether these can be entered from a 
keyboard or displayed in output varies with the device. A 
character having no glyph on the intended display device is 
represented by [ (“squish quad"). 





Alphabets 
The letters A-Z have 3 distinct representations in (AV. The 
principal alphabet (here designated by the abbreviation ALF!) 
is evoked by pressing the keys in the base (unshifted) case. The 
principal alphabet is the only one used for system commands, 
system functions and system variables. 


There is a second alphabet (abbreviated ALF2). usually em- 
ployed for emphasis. Its characters may appear in user-defined 
names for APL objects. Some devices also offer a third alphabet: 
where supported, its characters may appear in comments or as 
character data, but not elsewhere. 


Appearance of the alphabets 

Alphabetic characters in APL are defined to be italic. and are 
here shown that way, although many current devices lack italics 
and substitute roman. Early APL terminals used hard-copy 
printing and were restricted to a single set of alphabetic charac- 
ters. the capitals A-Z. They obtained a second or even third 
alphabet by overstriking a stress (underline) or dieresis or 
macron (overline). By convention, ALFI on such devices appears 
as capitals. 


More recently. certain devices (e.g. the IBM PC. the IBM 3270 
terminal) permit both caps and lower case to be intermixed with 
APL symbols. For two-alphabet devices that permit it, including 
SHARP APL/PC, ALFI appears as lowercase. ALF? as cups. 
(The IBM 3270 mav also be configured with three alphabets: 
in that case, ALF! is caps. ALF? underlined caps. ALF3 lower 
case. From an ASCII terminal which permits it, ALF3 mav be 
indicated by caps overstruck with macron.) 
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Columns 

Zero-origin index in Ca. 

APL character. Appearance of national use characters (named 
NUI. NU2, etc.) varies by country; characters shown follow Eng- 
lish-language convention in North America. For alternatives, see 
table of National Use Characters, p. 36. To select alternates on 
PC, see SHARP APL/PC Handbook, Appendix B. 

Character pairs available to construct the character during in- 
put, by overstriking, or with an overstrike escape sequence, order 
within pair not significant. 

Description. Where a character has an established name (for 
example, “dieresis”, “rho”, etc.) that name is shown, however, 
some characters have no agreed-on name, and so are described 
by the functions that they denote. 


$ Character to enter from an ASCII or Teletype keyboard not 
equipped with APL and signed on in “native” mode (using right 
paren above 9 or 0). 

6 Character to enter from an ASCII keyboard without APL 
keytops, but signed on as if for APL (right paren 2nd key 
to the right of letter L). Where two characters are shown, 
first is for typewriter-paired ASCII, second for bit-paired 
ASCII. 

7 Character to enter from a Telex keyboard. FS means “figure 
shift”. 

1 23 4 5 6 7 

0 Idle: If sent to display, no effect. 

1 NUL: Not sent 

2-3 UNUSED 

u $S| NU4 $ md FSH $ 
5 bel NULI ¢ 
6-13 UNUSED 

14 [ L Bracket [ : [ 
15] R Bracket ] pal ] 
16 ( L Paren ( : + ( ( 
17 ) R Paren ) ne ) 
18 g Semicolon : < ; 
19 1 Slash / / / 
20 N Back-slash \ ? \ 
21 + L Arrow; Is — [ € - + 
22 > R Arrow; Branch E 7 3 / > 
23-24 UNUSED 
25 7 Dieresis å 
26 + Plus + - + + 
27 - Minus = e FsF - 
28 x Times # = ^ x 
29 4: Divide % + 7 ż 
30 * Star, Povver e P ki 
31 f Max S f 
32 l Min D L 
33 | Stile ' M | 
34 A Caret; And a )- A 
35 v INV Caret; Or ( ) M 
36 < Less < # < 
37 $ Not greater $ < 
38 = Equals = g = 
39 2 Not less - & 2 
40 > Greater > kr 2 
uj z =/ Not equal e ( z 
42 a Alpha A a 
43 e Epsilon E € 
uh n lota I l 
45 p Rho & R e 
46 w Omega W w 
Dr >» Comma A ; , , 








83 

84-85 

86-11 
112 


-N 
D ru 


CDUN ++ B@’vOArF EG: 


Ho 
F < 


BD it? 8000 Ha 
Po <> or 


a 
I 


e O- 


M 
N 
U 


X l- 
E U: 
¥ To 
2 io 
Oe 
sn 
t (- 
) o] 
coke 


1 
A 


113-138 


139 


688. 


140-149 


150 
151 
152 
153 
154 
155 
156 
157 
158 


V 
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Shriek; Factorial 
Rotate 

Base value 
Represent 

Circle 

Query; Random 
Tilde; Not 

Up arrow; Take 
Down arrow; Drop 
Shoe 

Link 

Cap 

Cup 

Stress 

Transpose 
I-beam 

Jot 

Quad 
Quote-Quad 

Log 

Nand 

Nor 

Lamp; Comment 
Grade Up 
Grade Down 
Rotate First 
Over First 

Scan First 
Domino; Matrix Divide 
Thorn; Format 
Pawn; Execute 
Diamond 

Lev 

Dex 

R Brace 

L Brace 

UNUSED 
PRIMARY ALPHABET 
Delta 

SECOND ALPHABET 
Delta-stress 


NUMBERS zero through ni 


Dot 

Macron 
BLANK 
Quote 

Colon 

Del 
Newline; CR 
UNUSED 
BACKSPACE 


5 


ne 


6 


U "9 LOMNO x HMO O ZU 


a at ` ve? e zm a 
MA m 


m 


v 


a 


4 


FSG 


"A OD 39 ss 


C DUN + > 2 


SHTI Di adr, Ob D ZA BRO o Hi 
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o 
165 6 
166-191 
192 
193 1 
194 1 
195 
196 7 
197 ' 
198 ^ 
199 $ 
200 e 
201 $ 
202 
203 
204 
205 
206 
207 
208-218 
2197 7, 
220-240 
241-251 


ma — — = 2 


252 
253 
254 
255 


Framing characters are displayed (on IBM PC or 3270 terminals) 
by selecting from DAV at positions shown to the right: 


3 4 
LINEFEED 

V~ Del-tilde 
UNUSED 
UNUSED 


== Matches 


Paw; On 


o Hoof; Upon 


THIRD ALPHABET 


UNUSED 

li NU 2 

to NU 3 
UNUSED 

~/ NU A 

', NU 6 

V NU 7 

N= NU 8 

Qo NU H 

“t nu 10 

~ null 

Lo NU 12 

ol NU 13 

IN Nu 14 

+/ Percent 

a\ Ampersand 
UNUSED : 
Comma-Bar 
UNUSED 


Displayable on PC and 3270 terminals only: Single- 
line box-drawing characters (see below). 


Field mark. 
Dup mark. 
Full-screen null. 
UNUSED 


250 246 245 246 251 
241 152 241 152 241 
243 246 247 246 242 
241 152 241 152 241 
249 246 244 246 248 


€ 


A 
E osin 


LO 


O: octi 


2@ K 4-- 


RAM — ei = * 


-I 


- 
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ma € 
IBM has reserved 14 character-codes for ''national use"—that is, the 
glyph associated with such a code in one countrv mav differ from the 
glyph associated with it in another country. Warning: these characters 
are by definition ambiguous, and should not be relied on for text entered 
in one country and displayed in another. Publication of the table below 
is not intended to recommend these codes for the characters associated 
with them, but only to help predict how, if used, they may be displayed 
elsewhere. Since their appearances vary, each code is identified by a 
number, shown at the head of each column. The table shows the appear- 
ance of each according to the conventions for North American English 
and for 18 other conventions described by IBM. 
NUnumber I 2 3 4 5 6 7 8 9 10 11 12 13 14 
CAV index å 194 197 198 4199 206 196 202 203 204 205 193 201 
vo“ address JA SA 6A 79 5B 7B IC SF Al CO DO EO JF 7F 


North American € LP TØNES 
German Å U 6 S # Š esë AO AG 
Germania © å B UA OJ” å 
Danish. Norwegian # Z © A £0 ü æ a a ET 
Danish. Norwegiantal 0 a A E 8. æ 
Swedish. Finnish S = ö 6 A A O kar AE S. jii 
Swedish. Finnishtati o a A A OJ d $ 
French “Šš ù S £ å é è ç 1 
Italian © é ò ù $ £ $ på è go io" 
Portuguese | l-0 SA O vod ČC da 
Spansh fo) ñ RN a 7 i i i 
Spanish taltëmatet € 1 R Ne 7 n 
UK. S ` 1 # o Og ' 
Belgian | i u EEE EE 
Brazihan E S ç å C OA oe GK ġ 
Japanese English £ < xog EE FS M 
Latin-American Spanish [1] n SN se å 
Canadian French a u SHË EG 
international [I KE 0 7 5 Z i 
EXPLICIT CONTROL of TERMINAL I/O 
QARBIN and JAZBOUT are used to communicate device-specific control 
information between the APL workspace and the device managing jj 
APL session. The significance of a transmission received via DASEIN, 
or the effect of a transmission sent via QAZBOLT (or as the prompt with 


JARBIN) is highly specific to the device. What works with one device 
may have a quite different meaning or effect at another. 


QARBIN w Arbitrary input. System prompts for input by 
FARBOUT u. then accepts one entry from terminal up 
to and including first CR. 

Result: Numeric vector representing the received transmission, 
including its terminating CR. as integers between 0 and 
127. 

S-task: O-origin JAV-index of the characters which the control- 
ling task next uses to set shv. 


[JARBOUT w Arbitrary output. System transmits codes w to the output 
device. No explicit result. Effect and domain vary wit 
device and task-type. 

ASCII T-task: Domain: characters from 12810AV, or integers betwee 
0 and 511. 
Transmission: 125 |«. 

Parity: To an ASCII terminal connected via IPSANET or com 

mon-carrier network: even parity. 
To an ASCII terminal connected directly to IBM 370 
communications controller without an intervening net“ 
work: first row of 0 12874 sets parity as follows: 
0 Even. z Force 0 (space). 

1 Odd. 3 Force 1 (mark). 










am 


IBM T-task: Domain: characters from 12810AV, or integers betwee: 
0 and 127. 
Transmission: 64|«. preceded if necessary by 14 (vc) 
or 62 (LC) to indicate w>63. 

S-task: Domain: characters from DAV or integers between O an 
255. 
Effect on shared variable: For character u, 
shveu: for numeric w, sAw-DAVIDIO4tu). 





ASCII transmission codes Sf 


These are used by the APL system to manage input and output from 
ASCII terminals. They may be relevant to applications using QARBIN or 
DARBOUT. (Tables for terminals using the IBM BCD or Correspondence 
codes can be found in workspace 1 ABOUT, or the publication SATN- 
28.) Within columns headed APL/AsCII, where two entries are shown, 
the first is for typewriter-paired terminals, the second for bit-paired. 





APL/ APL/ APL/ 
ASCII ASCII ASCII ASCII ASCII ASCII 
0 NUL 43 + + ( 86 V U 
I SOH 44, $ 87 W w 
2 STX 45 - + 88 X > 
3 ETX 46. : 89 v + 
4 EOT 47 / / 90 Z c 
5 ENQ 48 0 0 91 I ++ 
6 ACK 491 1 92 \ -© 
7 BEL 50 2 2 93 J > { 
8 BS 51 8 3 947 >x 
9 HT 52 4 4 OG - A 
10 LF 535 5 96 * 0 > 
ll VT 54 6 6 97 a A 
12 FF 55 7 7 98 b B 
13 CR 56 8 8 99 c C 
14 so 579 9 100 d D 
15 SI 58 : (CJ 101 e E 
16 DLE 59 ; [ 102 f F 
17 DC1 XON 60 < ; 103 g G 
18 DC2 61 = x - 104 h H 
19 DC3 XOFF 62 > : 105 i I 
20 DC4 63 2 \ 106 j J 
21 NAK 648 "+ 107 k K 
22 SYN 65 A a 108 1 E 
23 ETB 66 B l 109 m M 
24 CAN 67 c n 110 n N 
25 EM 68 D L lll o O 
26 SUB 69 E € 112 p P 
27 ESC 70 F _ 113 q Q 
28 FS 71 G V llë r R 
29 GS 72H A 115 s S 
30 RS 731 1 116 t T 
31 US 74 J o 117 u U 
32 SP 75 K ' 118 v V 
33 1 ig 76 L D 119 w W 
34 v ) 7 77 M | 120 x X 
35 4 < 18N T ly $ 
36 $ < 790 o 122 z Z 
37% E 80 P * 123 { (3 
38 & > > 810 ? 124 ; - $ 
39 > j> 82 R e 125) } 
40 ( voz 83 S f 126 ` $ : 
41) A V 84T ~ 127 DEL 
42 e 2) 85 U 4 
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| Keyboard 


(HHH 
\ | LT) n U Le JL- 
E LE 
{ ( ) U i o V A 1 | L 
ElEBLLEEELBLBEJI 
= + X 1 4 4 ko d > m å 
UE EEE EEE 
d + — A L < < = > > - .. 


APL Terminal 


Keyboard 3 


40 


(vithout APL) connected to APL system l 


REN LU u A 2 X Z 

d < > W N A D X Z 

EE oe Ja Jes 
sr TIM tr fw kO Ja Ja KS Iw 
PE Go da aa lu la EN 
| tft I O N A L d H M 

TEDKA 

o 2 Sie SS ( ) E mite BV s % $ X HI A 


ASCII typewriter-paired terminal 
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FB PZ M tu lua oe 

i le > IN IN A 19 lix NZ 

GE Ja Joe Jo Ja als le 
{ [la all + | Ties fic IH fio Na S IV 
I Je la fos In la Ja a la Ja lo. 
} jlo. AVA TL a la JIM 

ME ETE AER E.L 

| C a ( ) i „Jo X + % $ X # li 





ASCII bit-paired terminal 
(without APL) connected to APL system 
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Teletype terminal 
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Keyboard 
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Telex terminal 
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Only during immediate execution of T-task or S-task. Bracketed vvords 





optional. | separates exclusive alternatives. Commands marked by *- 


inapplicable to PC. 


)[p] Edit immediate-execution line at end, or op- 
tionally by two-pass editing at position p. 


)nnnnnnni : passwd 1: newpass |] 
* Sign-on: invalid sign-on acts as )BLOT. See 
also Task initiation, pp. 20-21. 


)BLOT [n] Print a 35-character mask (or, optionally. of 
length n) for typing secure information. At 
PC or IBM 327x, creates a no=print zone. 


)CLEAR Clear the active ws. See also 07247 action 
D, p. 17. 


)CONTINUE [HOLD] [: passwd] 
Terminate a session and store the active ws 
in CONTINUE: set passwd. 


JIPICOPI nm |: passwd] [nm] nm? 
Copy global objects from saved ws: 
)PCOPY protects contents of active ws from 
being overwritten. 


)CPULIM [n [cum] ) $ Display or set limit on CPU time per key- 
board entry, or cumulatively for the dura- 
tion of task. 0 0 means no limit. 


)DROP nm I: passwd] Delete a stored ws. 
)ERASE nml nm) ... Erase global names. 


)FNS [aaa] List names of visible functions in alphabeti- 
cal order. optionally starting with aaa. See 
also 1 (WS 1. 


)GROUZ nm [nm] nm) ...) 
Form group am with members aml 
nm) ...; With no members. disperse group 


nm. 

)GRP nm List members of group nm. See also 
3 WS. 

)GRPS [aaa] List groups in alphabetical order, optionally 


starting with aaa. See also 1 [WS 4. p. 24. 


)KEYBOARD [LOCK |NOMSG] 


* Unlock or lock keyboard. or reject messages. 


)LIB [ann] [aaa] 370: List wss in library aan. in alphabetical 
order, optionally starting with aaa. 
)LIB la) PC: List wss on the default disks-drive (option- 


ally, those on drive a). 


NXILOAD nm [: passwd] Activate duplicate of stored ws. )XLOAD 
suppresses execution of DLX if you are ws's 


owner. See also DLOAD and QQLOAL. 


)MSGINI taskip [text] * Send message to terminal of designated 
task: )MSGN does not lock keyboard to re- 
ceive reply. 


)OFF [HOLD] [: passwd] Terminate work session; set passwd. See also 
JBJUNCE and Task termination, p. 20. 


)OPRINI text * Send message to SHARP APL operator; 
)OPRN does not lock sender’s keyboard to 
receive reply. 


)PORTS aaa|nnnnnnn * List port numbers and task ID's of task(s) 
| of account annanan or where first 3 charac- 
ters of account name are aaa. 
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JSE Clear si. See also ZZZA7 action 2. p. 17. 


) SAVE [nm |: passwd] ) 
Store duplicate of active ws. 


)SEAL Lock all fns. in active ws: prevent copying 
of contents or replacement of locked fns. 


)SIM Display state indicator; )SIV displays si and 
localized names. See also 2 [WS 2 and 
5 (WS, p. 24. 


)SYMBOLS [a] Displav/set symbol table size. See also 
ŻAWS 3: 


)TERMINAL (nm) * Display /set terminal type. Valid arguments: 
IDLES NOIBLES AJ832 DCTTAPE IOTTTYS 
SETi20900 MAX1240 REALTTY SDATA TYR. 
See also TERMINAL fns in WS 1 WSFXS, and 
wss in library 5. 


)VARS [aaa] List visible variables in alphabetical order. 
optionally starting with aaa. See also 
1 (WS 2. 


)WSID (nm [: passwd] ) Displav/set name of active ws. See also 
ZS di 


LINE-EDITING 


Available to T-task or S-task. during immediate execution or during 
7 editor. Where a is line number. and p is cursor position (p>0 and 
PS CNL evoke line editing by: 


Immediate Execution Function Definition 
One-pass: ) or )0 [alo] 
Effect: Display line: position cursor at right end. 
Two-pass: )p (np) 
Effect: Display line: position cursor on line below at position 


p 10 accept editing instructions. 


Two-pass editing 
(For hard-copy or similar devices unable to 
delete or insert characters within a line.) 
L of first dot or comma: / 10 delete characters; m to insert m blanks. 
R of first dot or comma: Text to R of first dot or comma is inserted 
into displaved line, to precede character 
above first dot or comma. 


Effect 

Following comma: System displays amended line: awaits new 
editing instructions. 

Following dot: System takes amended line without display- 

ing it. 

Following neither. System displays amended line with cursor 
on same line, at first inserted blank (i.e. one- 
pass editing). 


V FUNCTION EDITOR 


Available to T-task or S-task in immediate execution. 
T fnname Open editing of fn. named fnname 
S Close definition of fn. now being edited. 
v Close and lock fn. now being edited. 


While definition open: 


[a] (Re)define line © ' 

3 Display entire definition 

[a5] Display line a 

(0m) "` Display from line m to the end 

(ap) Edit line æ with cursor at p (see Line Editing) 
[aa] m2...) Delete lines ni m2... 

)p Copy last immediate-execution line as body of cur- 


rent line. and edit at position p. 











46 NETWORK MESSAGES 


The following is a list of messages issued through the SHARP APL 
service: other sites may substitute their own wordings. 





Before connected to aPL system 

LF, LF, BELL (No printed display) 
Network node requires destination ( right paren, or right paren 
followed by ID of the system desired). 

NO PATH 
Network node at present has no route to the indicated APL system 
(either because you have named a valid destination but there's 
no way to reach it, or because your entry does not identify an 
APL system). 

APL FULL 
Network node required to connect you to APL at present has 
insufficient capacity to do so. 

VM COMMAND REQUIRED 
You are connected to VM operating system, which requires a 
command in the form )VMxxxx to select an APL system. (Only 
in installations using VM.) 

APL DOWN 
Your call has reached the APL systems IBM 3705 communications 
controller, but the APL system is not running. 


After connected to APL system 


INCORRECT SIGN-ON: 
Your attempted sign-on does not consist of a right paren. 
a number, a colon, and a passwd. (Last character of the 
trouble message is a colon.) 

APL NOT AVAILABLE 
APL System running but not yet accepting sign-ons while complet- 
ing startup. 

NUMBER NOT IN xxx SYSTEM 
Number and passwd vou entered not recognized. 

NUMBER LOCKED OUT OF xxx SYSTEM 
Number exists but has been locked. preventing use of its account. 
workspaces, or files. 

NUMBER IN USE 
Your account already has an active T-task (and lacks permission 
to have more concurrent tasks than are already signed on). 

PATIENCE PLEASE 
APL system has not yet completed termination of your earlier 
T-task. 

RESEND 
Your last entry was not readable and has been lost. It must be 
re-sent from the beginning. 

ENTRY ERROR 
Your last entry contains illegal overstrike or undefined TAB, and 
must be re-transmitted from point in error. 

APL RESET 
1BM 3705 communications controller (through which you were 
previously connected to APL) has detected general reset of channel 
to APL, probably intervention by Operator following crash. 

LINES DOWN 
Node through which you were connected to aPL has lost contact 
with APL and has terminated your call. Your next entry should 
be system selection: that is, APL right paren or APL right paren 
followed by 1D of APL system desired. 

INBOARD DISABLE 
Only when connected directly to IBM 3705, without network. Your 
call has been terminated by APL, in response to )OFF or 
OBOUNCE. 
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nn GRB HH HHH BH 


-1 M I u 


«1 


~} 


I I 


BROUT 


PL keti å 


ETASKREG 
DATABASES 
D1 RECTDEF 
POSE ALO 
Fa Bon 
FORKAT 
HCPRIN 
HSPRINT 
INFO 


NETHORK 


NENS 
REFERENCE 
SATIN 

TS 


TST 
USAGE 
WSFNS 
ASK 
SAGA 
CH 
A?124 
FONT 


TERM 
STASK 
WSTRANSFEZ 
DEZ 

FVEL 
PROFILE 
WSDOC 
WSSEARCH 
XREF 


Tables of ASCII and IBM transmission codes. 
B-task submission. 

Directory of public databases. 

Compiling and displaving direct definitions. 
Functions complementary to file primitives. 
File sorting utility. 

Functions complementary to JFMT. 

Hard copy on IBM 3284 (from 3270 terminal). 
Remote highspeed print. 

Directory of programs and wss in public 
libraries. 

SHARP communications, with local access 
phones. 

System enhancements. schedules, announcements. 
On-line reference card. 

SHARP APL Technical Notes on-line. 
Timestamp decoding; local time at network 
nodes. 


Functions for use with TSIO auxiliary processor. 
Accounting information bv month. 

Workspace control functions. 

Prompting functions for interactive applications. 
SHARP APL graphics aids. 

Utilitv function to edit character vector. 
Functions for use with 3270 full-screen manager. 
Surrogates for APL work from non-APL 
kevboards. 

Documentation of )TERM 

Utility functions for managing an S-task. 
Source-format workspace interchange. 

Function editor for IBM 3270 terminals. 
Workspace-wide editing of functions. 

Utilities to set up and use workspace profiles. 
Workspace documentation package. 

Workspace searching and replacement fns. 
Cross-reference of name-use in ws. 
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